开始/停止计时器

# Start the timer with default configuration (25 min with alarm sound)
$ pomodoro-cli start

# Start a 30 min timer wihout playing alarm sound, but triggering a system notification
$ pomodoro-cli start --duration "30m" --silent --notify

# Stop the timer
$ pomodoro-cli stop

暂停/恢复计时器

# Pause the Timer (calling this command again will resume the timer)
$ pomodoro-cli pause

# Resume a paused timer
$ pomodoro-cli start --resume

向运行中的计时器添加更多时间

# Add 10 minutes to the timer (instead of starting a new timer)
$ pomodoro-cli start -add 10m

查询计时器状态

## Get remaining time in human readable format
$ pomodoro-cli status --format human

# Get the timer status in JSON format (for Waybar integration)
$ pomodoro-cli status --format json

# Specify the timer format in digital format (10:30) -- default
$ pomodoro-cli status --format human --time-format digital

# Specify the time format in segmented format (1h 30m 15s)
$ pomodoro-cli status --format human --time-format segmented

# Specify the time format in seconds
$ pomodoro-cli status --format human --time-format seconds

Waybar集成

将以下模块添加到您的waybar配置中

"custom/pomo": {
    "format": "   {}",
    "exec": "pomodoro-cli status --format json --time-format digital",
    "return-type": "json",
    "on-click": "pomodoro-cli start --add 5m --notify",
    "on-click-middle": "pomodoro-cli pause",
    "on-click-right": "pomodoro-cli stop",
    "interval": 1
},

CSS样式

该模块支持三种不同的状态： 运行中、暂停和完成。您可以通过在Waybar配置中添加以下CSS规则来自定义每个状态的样式

#custom-pomo.running {
  background: #304D30;
}

#custom-pomo.paused {
  background: #AB730A;
}

#custom-pomo.finished {
  background: #8F0808;
}

立即更新Waybar模块

如果您想在点击时立即让Waybar更新模块，可以将pkill -SIGRTMIN+10 waybar添加到on-click命令中。例如

"custom/pomo": {
    "on-click": "pomodoro-cli start --add 5m; pkill -SIGRTMIN+10 waybar",
    "signal": 10,
}

自定义

设置自定义警报声音

如果您想使用自定义警报声音，只需在~/.config/pomodoro-cli目录中添加一个alarm.mp3文件。

$ mkdir -p ~/.config/pomodoro-cli
$ cp /path/to/alarm.mp3 ~/.config/pomodoro-cli/alarm.mp3

设置自定义通知图标

如果您想使用自定义通知图标，只需在~/.config/pomodoro-cli目录中添加一个icon.png文件。

$ mkdir -p ~/.config/pomodoro-cli
$ cp /path/to/icon.png ~/.config/pomodoro-cli/icon.png

替代方案

• i3-gnome-pomodoro
• openpomodoro-cli
• rust-cli-pomodoro
• pomo