exclock是一个CUI扩展计时器。
项目描述
Exclock
exclock是一个CUI扩展计时器。
必需
- mplayer
- xmessage或terminal-notifier（如果您使用mac，我推荐terminal-notifier）
如何安装
$ pip install exclock
用法
$ exclock [options]
功能
- 在指定时间发出警报。
- 在指定时间经过后发出警报。
- 您可以灵活地设置警报。
选项
--version：显示程序版本号并退出-h, --help：显示此帮助信息并退出-c, --clock-name：设置时钟文件名-l, --list：显示PC中的时钟名称并退出-t, --time：直到或到达指定时间的时间-r, --ring-filename：用于与-t, --time选项一起响铃的音文件名。注意，如果您经常指定音文件名选项，则可以使用EXCLOCK_RING_FILENAME系统变量。--trace, --traceback：显示跟踪信息
如何在指定时间发出警报
输入
$ exclock -t {time}
格式命令。
时间以{hour}:{min}或{hour}:{min}:{sec}格式给出。
例.
$ exclock -t "1:00"
$ exclock -t "1:00:20"
如何在指定时间经过后发出警报
输入
$ exclock -t {time}
格式命令。
时间以{sec}，{sec}s，{min}m或{min}m{sec}s给出。
例.
$ exclock -t 3
$ exclock -t 3s
$ exclock -t 2m
$ exclock -t 2m3s
如何灵活地设置警报
输入
$ exclock -c {clock-filename}
格式命令。尽管{clock-filename}可以省略，如下所述。
时钟文件应该是json5格式的文件。
json5格式的官方网站是这里。
时钟文件格式
{
"title": "title(optional)",
"sounds": {
"time1": {
"message": "message1",
"sound_filename": "sound_filename1",
},
"time2":{
"message": "message2",
"sound_filename": "sound_filename2",
},
...
},
"show_message": show_message(optional),
"loop": loop_number(optional)
}
- title（可选）：用于通知的字符串。如果没有指定此选项，则从时钟文件名计算属性。
- 声音：从时间到字典的映射，包含消息和声音文件名。
- 时间格式为“{sec}”、“{sec}s”、“{min}m”或“{min}m{sec}s”格式。
- 消息是一个字符串，用于通知和终端输出。然后消息被替换为“{count}”以表示执行次数。
- sound_filename是一个字符串，用于播放声音。
- show_message(选项)：使用xmessage或terminal-notifier显示消息的布尔值
- loop(选项)：上述时钟计时器的迭代次数。如果这是nil，则表示重复一定次数。默认值为1。
在gitlab的sample目录中包含示例文件。
如何省略时钟文件名
在某些情况下可以省略时钟文件名。
规则如下
- 如果时钟文件名的扩展名为.json5，则可以省略扩展名（例如：pomodoro.json5 => pomodoro）。
- 如果目录位于指定的目录(~/.config/exclock/clock/或环境变量EXCLOCK_CLOCK_DIR)，则省略目录（例如：~/.config/exclock/clock/abc.json5 => abc）。
- 可以访问内置时钟文件。在gitlab的sample目录中（例如：3m或pomodoro）。
如何省略声音文件名
在某些情况下可以省略声音文件名。
规则如下
- 如果目录位于指定的目录(~/.config/exclock/sound/或环境变量EXCLOCK_SOUND_DIR)，则省略目录（例如：~/.config/exclock/sound/abc.mp3 => abc.mp3）。
- 可以访问内置声音文件。在gitlab的sample声音目录中（例如：silent.mp3或ring.mp3）。
许可协议
下载文件
下载适合您平台的文件。如果您不确定选择哪个，请了解有关安装包的更多信息。
源分布
exclock-0.4.6.tar.gz (70.2 kB 查看哈希值)
构建分布
exclock-0.4.6-py3-none-any.whl (69.9 kB 查看哈希值)
关闭
exclock-0.4.6.tar.gz的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | ea2340db49535f0f5340c1c021911ab4aad1b62e43110c5ba04e290a2194acfd |
|
| MD5 | 79e6d20592efa2a78cd6a904cb59858a |
|
| BLAKE2b-256 | c341275a3d45717d35cfdec516748830bfc4a93bff7da07fe0b16573798d37e1 |
关闭
exclock-0.4.6-py3-none-any.whl的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 6ecb8139278c20cf706e0f05a1f316ef293a81085e664e4ed508f55183c46bb4 |
|
| MD5 | 54ee7ac0680d3016f934111c56eb0dd4 |
|
| BLAKE2b-256 | d90e22c082e6728a6e194cd0a6caeb477be99811a2851e0b484dca6c02c1e9ac |