pomoff's Introduction

🍅 Pomoff

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.

pomoff's People

Contributors

Stargazers

Watchers

pomoff's Issues

Run script [main.py] with argument

@angelofallars
I suggest that we can run the main.py script with arguments.
As you can see here : https://github.com/rivo2302/pomoff/commit/307dac3cf54d16592757e215e2cad6e66f304f9b

Play a sound everytime a Pomodoro interval ends

Currently, the Pomodoro timer program just displays a pop-up every time a work or break interval ends. It should play a sound from the sound/ folder as well to improve the user experience. It should be implemented for Linux-based systems.