The Pomodoro timer is an applet for Polybar.

Features

• pomodoro
  • format: [completed_pomodoros current_pomodoro time] see pictures above
    • [ 00:00 ] - idle
    • [ ◔ 08:13 ] - work
    • [ ◑ 02:42 ] - break
    • [ ●● ◔ 07:50] - completed two pomodoros
  • 25-minute work sessions
  • 5-minute short breaks
  • 15-minute long breaks after 4 pomodoros
  • Color-coded display (orange for work, green for break, blue for long break)
  • Click controls: start/pause, reset, skip
  • Desktop notifications
  • Sound alerts
• [NEW FEATURE] stopwatch (like in leetcode.com)
  • it just increses time from 00:00:00
  • Click controls: start/pause, reset
  • Notify you every 10 minutes
  • Change color to more red every 20 minutes

Installation

1. Dependancies

• Ubuntu/Debian

sudo apt install python3-notify2 libcanberra-gtk3-module

• Arch Linux

sudo pacman -S python3-notify2 libcanberra

1. Clone the repository

git clone https://github.com/kirillin/polybar-pomodoro.git

2. Add module to Polybar ~/.config/polybar/config

• for pomodoro module

[module/pomodoro]
type = custom/script
exec = python3 ~/polybar-pomodoro/pomodoro.py
click-left = python3 ~/polybar-pomodoro/pomodoro.py toggle
click-middle = python3 ~/polybar-pomodoro/pomodoro.py reset
click-right = python3 ~/polybar-pomodoro/pomodoro.py skip
tail = true

• for stopwatch module

[module/stopwatch]
type = custom/script
exec = python3 python3 ~/polybar/polybar-pomodoro/stopwatch.py
click-left = python3 ~/polybar/polybar-pomodoro/stopwatch.py toggle
click-right = python3 ~/polybar/polybar-pomodoro/stopwatch.py reset
tail = true
interval = 1

3. Restart polybar

polybar-msg cmd restart

Usage

• pomodoro: Left-click start/pause, Middle-click reset, Right-click skip
• stopwatch: Left-click start/pause, Right-click reset

Changelog

• 08.10.2025
  • add stopwatch module
  • change sound for the end of a pomodoro to to multiple times play