A simple Pomodoro timer built in Rust. It uses the excellent ratatui library to render a terminal UI. It works nicely in a terminal multiplexer:
You can either download the binary from the release page, get the binary from crates.io:
cargo install pomodoro-tuiYou can then run the app with the following command:
pomodoro-tuiBy default, the timer is set to 25 minutes for work sessions and 5 minutes for breaks. You can change these values using the
-w/--work and -b/--break flags. You can also remove the ASCII art next to the timers using the -i/--hide-image flag.
For instance, if you want to set the work timer to 30 minutes and the break timer to 10 minutes, and hide the ASCII art, you can run:
pomodoro-tui -w 30 -b 10 -iOn Linux and MacOS, the app will send a desktop notification when the work or break time is over.
For MacOS users, the native say command is also used to read the notification short text... Don't be too surprised to hear a French accent!
Thanks to @Cythonic1 for adding Linux notification support!
This small project to learn Rust has been inspired by my partner, who likes and encourages me to use the Pomodoro technique, even if she doesn't always enjoy breaks when it's time...
I also want to thank the authors of the ASCII art used in the app, which are combinations of works by jgs and Felix Lee you can find here and here.