Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/coolcode/tomato-clock
Tomato Clock is a straightforward command-line Pomodoro application. https://en.wikipedia.org/wiki/Pomodoro_Technique
https://github.com/coolcode/tomato-clock
pomodoro pomodoro-timer python terminal terminal-app tomato tomato-timer
Last synced: 2 months ago
JSON representation
Tomato Clock is a straightforward command-line Pomodoro application. https://en.wikipedia.org/wiki/Pomodoro_Technique
- Host: GitHub
- URL: https://github.com/coolcode/tomato-clock
- Owner: coolcode
- License: mit
- Created: 2020-03-09T03:49:59.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-19T15:01:53.000Z (11 months ago)
- Last Synced: 2024-05-01T20:57:31.979Z (8 months ago)
- Topics: pomodoro, pomodoro-timer, python, terminal, terminal-app, tomato, tomato-timer
- Language: Python
- Homepage: https://pypi.org/project/tomato-clock
- Size: 125 KB
- Stars: 492
- Watchers: 4
- Forks: 110
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ð
Tomato Clock (Python)
[](https://github.com/coolcode/tomato-clock/actions/workflows/package.yml)
[](https://pypi.python.org/pypi/tomato-clock/)
Tomato Clock is a straightforward command-line Pomodoro application.
- [Pomodoro Technique](https://en.wikipedia.org/wiki/Pomodoro_Technique)
- [įŠčå·Ĩä―æģ](https://zh.wikipedia.org/zh-cn/%E7%95%AA%E8%8C%84%E5%B7%A5%E4%BD%9C%E6%B3%95)
- [Tomato Clock (Rust)](https://github.com/coolcode/tomato-clock-rs)
## Installation
[Install python](https://www.python.org)
- Install via pip:
```sh
pip install tomato-clock
```
- Install via source code:
```sh
git clone https://github.com/coolcode/tomato-clock.git
cd tomato-clock
chmod +x tomato.py
```
## How to use
- if you install via pip
```sh
tomato # start a 25 minutes tomato clock + 5 minutes break
tomato -t # start a 25 minutes tomato clock
tomato -t # start a minutes tomato clock
tomato -b # take a 5 minutes break
tomato -b # take a minutes break
tomato -h # help
```
- if you install via source code
```sh
./tomato.py # start a 25 minutes tomato clock + 5 minutes break
./tomato.py -t # start a 25 minutes tomato clock
./tomato.py -t # start a minutes tomato clock
./tomato.py -b # take a 5 minutes break
./tomato.py -b # take a minutes break
./tomato.py -h # help
```
## Terminal Output
```sh
ð
tomato 25 minutes. Ctrl+C to exit
ð
ð
---------------------------------------------- [8%] 23:04 â°
```
## Desktop Notification
- MacOS
```sh
brew install terminal-notifier
```
`terminal-notifier` actually is a cross-platform desktop notifier, please refer to â [terminal-notifier](https://github.com/julienXX/terminal-notifier#download)
- Ubuntu
`notify-send`
## Voice Notifications
Tomato Clock uses `say`(text-to-speech) for voice notifications.
- MacOS
MacOS already has `say`. see [here](https://ss64.com/osx/say.html) or [more detail](https://gist.github.com/mculp/4b95752e25c456d425c6)
- Ubuntu
See this link: [say](http://manpages.ubuntu.com/manpages/trusty/man1/say.1.html)
```sh
sudo apt-get install gnustep-gui-runtime
```
- Windows
Check this one: https://github.com/SeanBracksDev/tomato-clock