/tomato-timer

CLI pomodoro timer

Primary LanguagePythonMIT LicenseMIT

🍅 Tomato Timer

PyPI version

Tomato Timer is a simple command line pomodoro app.

Installation

Install python from https://www.python.org/

  • Install via pip:
$ pip install tomato-timer
  • Install via source code:
$ git clone https://github.com/pashkatrick/tomato-timer.git
$ cd tomato-timer
$ chmod +x tomato.py

How to use

  • if you install via pip
$ tomato                              # start a 20 minutes tomato clock + 10 minutes break in 9 times
$ tomato --work 25 --rest 5 --loop 4  # start a 25 minutes tomato clock + 5 minutes break in 4 times
$ tomato -h                           # help
  • if you install via source code
$ ./tomato.py                              # start a 30 minutes tomato clock + 10 minutes break in 9 times
$ ./tomato.py --work 25 --rest 5 --loop 4  # start a 25 minutes tomato clock + 5 minutes break in 4 times
$ ./tomato.py -h                           # help

Terminal Output

🍅 tomato 25 minutes. Ctrl+C to exit
 🍅🍅---------------------------------------------- [8%] 23:4 ⏰

Desktop Notification

  • MacOS
$ brew install terminal-notifier

terminal-notifier actually is a cross-platform desktop notifier, please refer to ➜ terminal-notifier

terminal-notifier

  • Ubuntu

notify-send

ubuntu-notification

Voice Notification

We use say(text-to-speech) for voice notification

  • MacOS

MacOS already has say. see here or more detail

  • Ubuntu

see this link: say

sudo apt-get install gnustep-gui-runtime