3 个版本
0.0.3 | 2023 年 8 月 9 日 |
---|---|
0.0.2 | 2023 年 4 月 23 日 |
0.0.1 | 2023 年 2 月 24 日 |
113 在 多媒体 类别中排名
每月 25 次下载
92KB
2K SLoC
cmus-notify:这是一个用 Rust 编写的 cmus 状态通知工具,易于配置和使用,适用于不同目的。它提供曲目更改、状态更改、音量、播放模式等通知。
注意:该项目仍处于早期阶段,尚未准备好用于生产。它目前作为一个仅供娱乐的项目在开发中。如果您有兴趣贡献,请随时提交问题或 pull request。
安装
- 您可以从 crates.io 使用
cargo install cmus-notify
安装最新版本 - 您也可以使用
cargo install --git https://github.com/anas-elgarhy/cmus-notify
从 git 仓库安装最新版本 - 如果您使用 Arch Linux,您可以使用您喜欢的 AUR 辅助工具安装 AUR 包。例如:
yay -S notify-cmus
用法
- 在终端中运行
cmus-notify
以启动程序,程序将在后台运行,并通知您 cmus 状态更改 - 您还可以运行
cmus-notify --help
来查看可用选项,您也可以在 用法文档 中查看可用选项 - 您还可以使用配置文件来配置程序,您基本上有与命令行参数相同的选项,但您还可以使用配置文件设置命令行参数的默认值。默认配置文件路径为
~/.config/cmus-notify/config.toml
,您也可以使用--config
选项指定自定义配置文件路径。如果不存在,默认配置文件将在~/.config/cmus-notify/config.toml
中创建 - 推荐使用程序的方式是在启动
cmus
音乐播放器时将其作为后台运行,您可以通过在shell配置文件中为cmus
创建别名来实现,例如:alias cmus="cmus-notify --link & cmus"
,--link
选项会将cmus-notify
进程链接到cmus
进程,所以当您关闭cmus
时,cmus-notify
进程也会被终止。
开发
- 此项目是用Rust编写的,因此您需要在系统上安装Rust,您可以使用rustup来安装Rust。
- 此项目,就像大多数Rust项目一样,使用
cargo
作为构建系统。但为了使我的生活更轻松,我决定使用just作为任务运行器,因此您需要使用以下命令安装just
:cargo install just
Just任务
- 要构建项目,以启用所有功能,在调试模式下运行
just build
。 - 要以发布模式构建项目,以启用所有功能,运行
just build--release
。 - 要构建并运行项目,运行
just run
,这将构建项目并在调试日志级别下运行它。 - 您可以使用
just c
来运行带有所有功能的cargo check
。 - 您可以使用
just t
来运行带有所有功能的cargo test
。 - 您可以使用
just show-help
来显示cmus-notify
程序的帮助信息。 - 您可以使用
just coverage-report
来生成项目的覆盖率报告,并在默认浏览器中打开它,报告将生成在target/coverage
目录中,此任务需要在您的系统上安装grcov。
您可以在justfile中查看所有可用的任务和别名,或者通过运行
just --list
来查看。
依赖关系
~18–51MB
~617K SLoC