1 个不稳定版本
0.1.0 | 2024年3月8日 |
---|
#822 在 命令行工具
490KB
3.5K SLoC
pwalarmd/pwalarmctl
pwalarmd 是一个基于守护进程的命令行(终端)闹钟系统。它具有以下功能:
- ⏰ 您可以配置任意数量的闹钟
- 🎨 许多个性化选项,包括自定义声音和与现有通知代理的集成
- 🖥️ 支持 PipeWire 和 PulseAudio
- 💾 简单的配置重载/保存,包括通过
pwalarmctl
工具
安装
发行版软件包
我们还没有任何发行版软件包。如果您想要本地发行版软件包,请帮助贡献!
手动安装
选项 1: Crates.io
使用 cargo
进行安装
cargo install pwalarmd
cargo install pwalarmctl
选项 2: GitHub
克隆仓库
git clone https://github.com/amyipdev/pwalarmd.git
根据需要进入和运行应用程序
cd pwalarmd
# For pwalarmd
cargo run
# For pwalarmctl
cd pwalarmctl
cargo run -- <options>
或者,将其安装到系统中(未经测试)
cd pwalarmd
cargo install --path .
cd pwalarmctl
cargo install --path .
安装后
您需要配置 pwalarmd;这包括提供声音资源。
配置
您可以通过设置环境变量 PWALARMD_CONFIG
为路径来设置自定义配置路径。所有路径都应该是 绝对路径 以避免守护进程化的问题。否则,pwalarmd
首先查找 ~/.config/pwalarmd/pwalarmd.toml
,然后查找 /etc/pwalarmd.toml
。
如果您正在尝试故障排除或调试,请设置环境变量 PWALARMD_NODAEMON=0
或在您的配置中设置 daemon = false
。
使用方法
运行 pwalarmd
以启动守护进程。
运行 pwalarmctl
以控制它或修改当前正在使用的配置文件。有关 pwalarmctl
的帮助,请运行 pwalarmctl help
。
要删除闹钟,请运行 pwalarmctl list
,并注意要删除的闹钟左侧的 8 个字符;然后您可以运行 pwalarmctl remove N
,其中 N 是这些字符,以删除闹钟。
贡献
我们非常欢迎贡献!目前没有正式的贡献指南,但您可以通过发送拉取请求来贡献;我们要求您在提交的最后添加 Signed-off-by: Name <email>
。
如果您发现错误或想要新功能,请随时提出问题。
限制和已知问题
pwalarmd
可能会在格式错误的包下崩溃。目前正在努力防止这种情况发生。
授权和版权信息
本项目由 Amy Parker/amyipdev 制作。
版权所有 (C) 2024 Amy Parker,[email protected]。
pwalarmd 和 pwalarmctl 采用 GPLv 许可。您可以在 LICENSE 文件中查看许可协议。
该项目使用 Rust 构建,并使用了多个 Rust 包。您可以在 Cargo.toml
和 pwalarmctl/Cargo.toml
中看到这些包。
动机
Windows、macOS、iOS 和 Android 都有可用的闹钟子系统。在大多数 Linux 发行版中都没有这样的东西。通常没有基于 CLI 的,它们都是 GUI 应用程序;它们还经常需要保持相应的 GUI 应用程序始终打开,这不符合很多使用场景。
依赖项
~4–35MB
~541K SLoC