tc

tomato-clock

Pomodoro 番茄工作法 https://en.wikipedia.org/wiki/Pomodoro_Technique

Showing:

Popularity

Downloads/wk

0

GitHub Stars

289

Maintenance

Last Commit

2yrs ago

Contributors

2

Package

Dependencies

0

License

MIT

Categories

Readme

🍅 Tomato Clock

Python package CI tomato-clock PyPI version tomato-clock

Tomato Clock is a simple command line pomodoro app.

Pomodoro 番茄工作法 https://en.wikipedia.org/wiki/Pomodoro_Technique

Installation

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

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

How to use

  • if you install via pip

$ tomato         # start a 25 minutes tomato clock + 5 minutes break
$ tomato -t      # start a 25 minutes tomato clock
$ tomato -t <n>  # start a <n> minutes tomato clock
$ tomato -b      # take a 5 minutes break
$ tomato -b <n>  # take a <n> minutes break
$ tomato -h      # help
  • if you install via source code
$ ./tomato.py         # start a 25 minutes tomato clock + 5 minutes break
$ ./tomato.py -t      # start a 25 minutes tomato clock
$ ./tomato.py -t <n>  # start a <n> minutes tomato clock
$ ./tomato.py -b      # take a 5 minutes break
$ ./tomato.py -b <n>  # take a <n> minutes break
$ ./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

Package & Publish

pip install setuptools wheel twine
rm -rf dist && python setup.py sdist bdist_wheel
twine upload dist/*

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100