2 个不稳定版本
0.3.0 | 2019年1月18日 |
---|---|
0.1.0 | 2019年1月14日 |
#13 in #alarm
91KB
525 行
dlarm
dlarm 是 dwm 的闹钟系统。
与 dwm 一样,dlarm 采用了极简、以键盘为中心的设计。dlarm 所做的只是允许你为今天晚些时候设置一个闹钟。当闹钟响起时,你的 dwm 状态栏会闪烁你指定的字符串或文本 ALARM ALARM ALARM
。然后你可以关闭或延迟闹钟。
它看起来像这样
安装前提
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