SYLO Python Pomodoro Timer


Keywords
pomodoro, tomato, timer, terminal, pomodoro-timer, productivity, todo-list, tasks, to-do, gtd, cli, pomodoro-timer-music, python
License
MIT
Install
pip install sylo==2.5.4

Documentation

SYLO

PyPI version Contributions welcome License: MIT

Sort Your Life Out with SYLO, a Pomodoro timer for your terminal!

Install

Mac + Linux only

pip install sylo

Run

sylo

Configure

Config file

TOML Config file can be placed in the home directory ~/.sylo/sylo.cfg.

[general]
audio_file = "/home/karen/Documents/my_funny_noise.wav"
time_segment_name = 'chips'

[display]
theme = "red"
fewer_colors = 0 #This is to help support some terminal themes which don't differentiate between light and dark colorama colors

[durations]
work = 25
rest = 5

Optional arguments

Arguments added through the command line will overwrite those in the config file.

  • -w --work_time Overwrite the default time in minutes to work (default is 25 minutes)
  • -r --rest_time Overwrite the default time in minutes for a rest (default is 5 minutes)
  • -a --audio_file Set absolute path to an audio file to play when the timer ends.
  • -t --theme Choose a different color scheme from the default

⚠️ Keep your audio files short!: SYLO is not sophisticated enough to shorten them yet

Example usage

sylo -w 20 -r 10 -a ~./path/to/my/audio/file.wav -t yellow

Data files

Data is persisted to disk at ~/.sylo/*.dat, if you remove the files you will lose your work history.

Acknowledgements

SYLO uses;