Omahub
← All plugins
M

Pomodoro

by markbusking

Pomodoro focus timer with work/break phases, progress, and desktop notifications

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
54dec95
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
54dec95
Reviewed
1 month ago

The plugin is a self-contained QML bar widget implementing a Pomodoro timer; the only external commands it runs are a fixed notification helper from OMARCHY_PATH and /usr/bin/pw-play playback of system sound files, with no shell interpolation or user-controlled arguments. There is no install-time script, persistence, credential access, or destructive behavior. The deterministic scan's 'none' rating matches this manual review.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/markbus-ai/omarchy-pomodoro --enable
Productivity #bar #quickshell

Pomodoro

A Pomodoro focus timer for the Omarchy shell: a bar pill that counts down the current phase, a popup controller, desktop notifications and system sounds when a phase completes.

Panel.qml owns the bar pill and the popup. The timer cycles work, short break, and long break phases; the bar pill tints by phase — the theme accent while focusing, a distinct green during breaks — so you can read the state at a glance without opening anything.

What you see

  • Bar pill — stopwatch glyph and remaining time. Green coffee during breaks. Middle click starts/pauses without opening the popup.
  • Popup — phase label with pomodoro count dots, a large remaining-time readout, a progress bar, and transport buttons. Keyboard: Space start/pause, R reset, S skip, Esc close.
  • Notifications + sound — phase completion fires a desktop notification and plays a system sound (alarm-clock-elapsed after work, complete after a break).

Install

omarchy plugin add https://github.com/markbus-ai/omarchy-pomodoro --enable

The widget joins the bar's default layout at the next shell reload (omarchy-restart-shell). Remove it with:

omarchy plugin remove markbusking.pomodoro

Settings

Settings live in the widget's entry in ~/.config/omarchy/shell.json. Set them with omarchy bar set markbusking.pomodoro <key> <value>:

Key Default What it does
workMinutes 25 Work phase length in minutes
shortBreakMinutes 5 Short break length in minutes
longBreakMinutes 15 Long break length in minutes
pomodorosPerCycle 4 Completed work sessions before a long break
sound true false silences the phase-end sounds
breakColor "#a6e3a1" Color used for the break pill (catppuccin green)

Numbers need --json, or they land in shell.json as strings:

omarchy bar set markbusking.pomodoro workMinutes 50 --json
omarchy bar set markbusking.pomodoro sound false --json

Interactions

  • Bar pill: left = popup, middle = start/pause, tooltip shows phase + time.
  • Popup: Space start/pause, R reset, S skip, Tab moves to the neighboring bar panel, Esc closes.
  • IPC: omarchy-shell markbusking.pomodoro <open|close|toggle>.

License

MIT.