2 个不稳定版本

0.3.0 2019年1月18日
0.1.0 2019年1月14日

#13 in #alarm

MIT 许可证

91KB
525

dlarm

dlarm 是 dwm 的闹钟系统。

与 dwm 一样,dlarm 采用了极简、以键盘为中心的设计。dlarm 所做的只是允许你为今天晚些时候设置一个闹钟。当闹钟响起时,你的 dwm 状态栏会闪烁你指定的字符串或文本 ALARM ALARM ALARM。然后你可以关闭或延迟闹钟。

它看起来像这样

Gif depicting dlarm alarm sounding

安装前提

dwm

dlarm 需要 dwm。如果你还没有安装它,可以从 dwm.suckless.org 安装。如果你想让 dlarm 支持其他极简窗口管理器,请打开一个 issue 并告诉我。

dwm-statuscolors (可选)

dlarm 与应用了 dwm-statuscolors 补丁的 dwm 配合得最好。这个补丁允许在 dwm 的状态栏中输出颜色;如果没有这个补丁,dlarm 仍然可以工作,但不会有颜色。如果你还没有这个补丁,可以从 dwm.suckless.org/patches/statuscolors 安装。

Rust

目前,dlarm 需要在你的系统上安装 Rust 工具链。如果你想有一个预编译的二进制文件,请打开一个 issue 并告诉我你的目标架构。

安装说明

安装 dlarm

使用 Cargo 安装 dlarm,命令为 cargo install dlarm

安装 man(1) 页面和 zsh 补全(可选)

克隆此仓库并运行 sudo make install 以自动安装 man 页面和 zsh 补全。

安装其他 shell 补全(可选)

如果你使用不同的 shell,可以使用生成命令(例如,dlarm generate bash)为你使用的 shell 生成补全脚本。你也可以使用此命令生成 man 页面。dlarm 支持 bash、elvish、fish 和 zsh 补全。

编辑你的 .xinitrc 或其他文件以启用 dlarm

最后,编辑包含设置您dwm状态栏脚本的任何文件。通常,这是.xinitrc或其他初始化脚本。它应该包含一个无限循环的某种脚本,用于更新您的dwm状态栏信息(例如,时钟)。

一旦找到该脚本,将dlarm仓库中的适当脚本粘贴进去。如果您使用dwm-statuscolors,则应使用script_for_color.sh;如果不使用,则应使用script_without_color.sh。如那些文件所示,您应将现有的脚本移动到新脚本中的else块中——这样,当闹钟被触发时,将显示闹钟,而正常状态信息将在其他时间显示。

可选地,如果您使用dwm-statuscolors,可以编辑脚本以选择当闹钟警报时显示哪些颜色。回想一下,您通过指定与您在config.h中定义的颜色顺序相对应的二进制值来指定dwm-statuscolors的颜色(例如,您定义的第三种颜色为\x03)。

用法

您可以使用--set--message--snooze--off命令与dlarm交互。有关其他用法详情,请参阅--help命令或man(1)页面。

设置闹钟时,您必须以H:MMpp格式(例如,1:35pm)或H:MM格式(例如,11:30)传递时间。如果您没有包含点(am/pm),则dlarm将猜测时间段:如果该时间在将来,则设置为AM时间,否则设置为PM时间。

目标和非目标

我的目标是让dlarm简单、极简,并且可由用户配置。我计划继续开发dlarm;未来的计划包括允许设置相对于当前时间的闹钟(例如,dlarm --set +25设置25分钟后的闹钟)。如果对此有简洁的兴趣,我也愿意支持除dwm以外的其他极简窗口管理器。

然而,我计划避免功能蔓延:dlarm不是一个通用日历系统,可能不会支持任意未来的闹钟(例如,明年1月30日的闹钟)。目的是有一个针对性短期闹钟,足以引起您的注意——而不是成为更多数字噪音的一部分。

错误报告和贡献

dlarm正在积极开发中,并欢迎更多的贡献者。请随时提交问题、创建拉取请求或以其他方式贡献。您也可以通过电子邮件提交错误报告、补丁、功能请求或评论至[email protected]

依赖关系

~5–16MB
~169K SLoC