#alarm #notifications #notify #pwalarmctl

app pwalarmd

基于守护进程的可配置命令行闹钟

1 个不稳定版本

0.1.0 2024年3月8日

#822命令行工具

GPL-2.0-or-later

490KB
3.5K SLoC

pwalarmd/pwalarmctl

Crates version pwalarmd Crates version pwalarmctl GitHub version License

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.tomlpwalarmctl/Cargo.toml 中看到这些包。

动机

Windows、macOS、iOS 和 Android 都有可用的闹钟子系统。在大多数 Linux 发行版中都没有这样的东西。通常没有基于 CLI 的,它们都是 GUI 应用程序;它们还经常需要保持相应的 GUI 应用程序始终打开,这不符合很多使用场景。

依赖项

~4–35MB
~541K SLoC