Plugins Pomodoro

Pomodoro Plugin

A Pomodoro timer with a circular progress ring. Work sessions and break intervals are fully configurable.

---

Installation

mado plugin install pomodoro

Restart Mado to activate the panel.

---

Usage

Click the ring or the centre to start and pause the timer. The plugin cycles automatically through work sessions and breaks:

1. Work session
2. Short break
3. Work session
4. Short break
5. … (repeat)
6. Long break after every 4 work sessions

A macOS notification is sent when each session or break ends.

---

Configuration

Config lives at ~/.config/mado/plugins/pomodoro.toml:

work_mins                  = 25
short_break_mins           = 5
long_break_mins            = 15
sessions_before_long_break = 4

All fields are optional — the defaults above are used if no config file exists.

---

FAQ

The notification didn't appear. Check that Mado has notification permissions in macOS System Settings → Notifications.

How do I reset the session count? Restart Mado — the session counter resets on launch.

Can I skip a break? Click the ring during a break to skip straight to the next work session.