15个稳定版本
| 2.0.0 | 2023年8月1日 |
|---|---|
| 1.6.0 | 2022年3月28日 |
| 1.5.0 | 2022年2月28日 |
| 1.4.2 | 2021年11月14日 |
| 0.0.0 | 2021年3月5日 |
#36 in 多媒体
44每月下载量
120KB
3.5K SLoC
empress: 简化MPRIS媒体控制
此工具作为D-Bus MPRIS规范的简单命令行抽象,允许查询和控制媒体播放器。它的工作方式类似于playerctl,但具有更基本的控制和更复杂的跟踪您想要控制的播放器的方法。 empress使用自己的D-Bus守护进程跟踪当前正在播放的播放器(以及最近更新最多的播放器),并使用这些信息来确定您是想暂停Spotify而不是播放最小化的YouTube视频。
安装
要安装empress,只需使用Cargo
$ cargo install empress
(或者,如果您使用Arch,我维护了这个AUR包:)
$ yay -S empress
然后启动守护进程以便使用它——您可能希望将其放入rcfile中(或者见下文设置服务)
$ empress server
如果中断或用SIGTERM信号通知,服务器将优雅地关闭。
使用方法
一旦设置好守护进程,您可以使用几个子命令之一与其通信,例如
$ empress play-pause
Empress有用于基本播放器操作的命令(例如now-playing、play/pause/play-pause/stop、next/previous/seek、volume),以及几个用于更高级操作的实用子命令(如list-players和switch-current)。要查看命令列表或获取特定命令的帮助,请运行empress help。
将empress安装为服务
empress可以作为服务安装,以便使用D-Bus和systemd自动启动和生命周期管理。为此,请运行以下命令
$ scripts/install-services.sh -l <path to empress binary>
这将安装D-Bus和systemd服务文件到~/.local/share。如果您使用empress与cargo install安装,二进制文件的路径可能看起来像/home/<user>/.cargo/bin/empress。
如果您想进行系统级安装,只需省略-l标志。这将把会话服务文件安装到/usr(但请注意,empress 永远不会作为D-Bus系统总线运行)。
一旦empress作为服务安装,运行上面列出的任何empress客户端命令都会自动启动守护进程。
卸载
要删除已安装的服务定义,只需运行
$ scripts/install-services.sh -rl
与上面一样,移除-l以从系统文件夹中卸载服务文件。
依赖关系
~15–31MB
~443K SLoC