pomoff

🍅 A minimalist command-line Pomodoro timer. Get work done.

MIT License

Stars
13

Pomoff, a minimalist Pomodoro timer made in Python.

  • Configurable durations for work, short break and long break in config.py
  • Sound + notifications when each interval is done
  • Easy to hack and make your own changes

Installation

Axyl OS

sudo pacman -S axyl-pomoff-git

Other operating systems (Linux)

git clone https://github.com/angelofallars/pomoff
cd pomoff
bash ./install.sh

To uninstall, run bash ./uninstall.sh.

Dependencies

  • python3
  • mpv

Run

After installing, simply type pomoff into the command line.

Usage: pomoff [option] ...
  -h, help               see this help page
  -w, work               launch a work interval
  -b, break, shortbreak  launch a short break interval
 -lb, longbreak          launch a long break interval

The config file is located in the /config directory of the pomoff folder.

Configuration

In the config.py file, you can edit the duration of the work and break intervals, change the sound and volume of the end-of-interval bell and more.

Contributing

Just make sure to develop and make pull requests on the dev branch instead of the main branch.

Contribute to pomoff and get your awesome profile picture displayed here!

Made with contrib.rocks.

Supporting this project

This project is free and open-source and will always be that way.

If you like this project, please consider donating to help me improve this project even further.