# pomodorotimer (CLI Pomodoro Timer)
Console Pomodoro timer with playing the melody of the signal or with the
generation of an end time signal. Displays a push notification on Linux and
Mac OS X.
**Support**: [](https://www.paypal.me/patsuckow) or [](https://www.buymeacoffee.com/patsuckow)
# Pomodoro Technique:
Pomodoro Technique - [see](https://en.wikipedia.org/wiki/Pomodoro_Technique)
We will use the traditional Pomodoro scheme:
### It is important:
**According to the principle of the Pomodoro technique - if you are
distracted while doing work, then you must interrupt the current time
and start a new Pomodoro. And this means that you need to write time in to
the database only after the specified time has passed and not earlier.**
**If you follow this principle, the Pomodoro Technique will be for you exactly
the tool for which it was invented, namely, not to calculate the time of your
work and breaks in work, but to make you concentrate on continuous and
concentrated execution of works during one Pomodoro, i.e. within 25 minutes.**
---
We call the program from any directory in the console and set the countdown
time:
When the time ends, a sound signal will be played, push notification will be
displayed and it is proposed to enter a new countdown time. And also, it will
display the time that is OUT, in the form of a colored time bar, where:
- red color - working time (25 minutes)
- green color - time for a short or long break (5, 15 or 30 minutes)
The type of push notification depends on your OS and the type of graphical
shell used, for example:
## How to install:
#### From PyPI:
pip install pomodorotimer
#### From sources:
Alternatively you can install **pomodorotimer** from sources directory:
git clone https://github.com/patsuckow/pomodorotimer
cd pomodorotimer
pip install -r requirements.txt
pip install .
cd ..
rm -rf pomodorotimer
## How run **pomodorotimer**:
```
pomodoro
```
## Work with statistics Pomodoro`s:
Get statistics today:
```
pomodoro --statistic=today
```
We get something like this in the browser window:
All-Time Statistics:
```
pomodoro --statistic=all
```
We get something like this in the browser window:
Delete (clear) statistics for today:
```
pomodoro --statistic=delete-today
```
Delete (clear) all statistics:
```
pomodoro --statistic=delete-all
```
## Requirements:
See in requirements.txt
**pomodorotimer** works with python 3.10.13 or higher.
## How uninstall **pomodorotimer** ðŸ˜:
```
pip uninstall pomodorotimer
```
## Licence:
## Authors:
**Alexey Patsukov 🇷🇺** - [GitHub profile](https://github.com/patsuckow)
### Submit issues
If you spotted something weird in application behavior or want to propose a
feature you are welcome.
### Write code
If you are eager to participate in application development and to work on an
existing issue (whether it should
be a bugfix or a feature implementation), fork, write code, and make a pull
request right from the forked project page.
### Spread the word
If you have some tips and tricks or any other words that you think might be of
interest for the others — publish it
wherever you find convenient.
Read also:
- https://francescocirillo.com
- https://habr.com/ru/post/446996/
- http://career-philol.ru/page/adaptive/id341091/blog/3189767/
Raw data
{
"_id": null,
"home_page": "https://github.com/patsuckow/pomodorotimer",
"name": "pomodorotimer",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10.13",
"maintainer_email": "",
"keywords": "pomodoro,tomato,pomodorotimer,pomodoro timer,pomodoro technique,productivity,time management,countdown,stopwatch,timer,eta,freelance,freelancing,CLI",
"author": "Alexey Patsukov \ud83c\uddf7\ud83c\uddfa",
"author_email": "patsuckow@yandex.ru",
"download_url": "https://files.pythonhosted.org/packages/8c/84/a99d39526f592a29d17b492c88e4042867fbc60ce0982de10544c7622519/pomodorotimer-0.2.4.tar.gz",
"platform": null,
"description": "# pomodorotimer (CLI Pomodoro Timer)\nConsole Pomodoro timer with playing the melody of the signal or with the \ngeneration of an end time signal. Displays a push notification on Linux and \nMac OS X.\n\n**Support**: [](https://www.paypal.me/patsuckow) or [](https://www.buymeacoffee.com/patsuckow)\n\n# Pomodoro Technique:\nPomodoro Technique - [see](https://en.wikipedia.org/wiki/Pomodoro_Technique)\n\n\n\nWe will use the traditional Pomodoro scheme:\n\n\n\n### It is important:\n**According to the principle of the Pomodoro technique - if you are\ndistracted while doing work, then you must interrupt the current time\nand start a new Pomodoro. And this means that you need to write time in to\nthe database only after the specified time has passed and not earlier.**\n\n**If you follow this principle, the Pomodoro Technique will be for you exactly \nthe tool for which it was invented, namely, not to calculate the time of your \nwork and breaks in work, but to make you concentrate on continuous and \nconcentrated execution of works during one Pomodoro, i.e. within 25 minutes.**\n\n---\n\nWe call the program from any directory in the console and set the countdown \ntime:\n\n\n\nWhen the time ends, a sound signal will be played, push notification will be \ndisplayed and it is proposed to enter a new countdown time. And also, it will \ndisplay the time that is OUT, in the form of a colored time bar, where:\n- red color - working time (25 minutes)\n- green color - time for a short or long break (5, 15 or 30 minutes)\n\n\n\n\n\n\n\n\n\nThe type of push notification depends on your OS and the type of graphical \nshell used, for example:\n\n\n\n## How to install:\n\n#### From PyPI:\n\n pip install pomodorotimer\n\n#### From sources:\n\nAlternatively you can install **pomodorotimer** from sources directory:\n\n git clone https://github.com/patsuckow/pomodorotimer\n cd pomodorotimer\n pip install -r requirements.txt\n pip install .\n cd ..\n rm -rf pomodorotimer\n\n## How run **pomodorotimer**:\n```\npomodoro\n```\n\n## Work with statistics Pomodoro`s:\n\nGet statistics today:\n```\npomodoro --statistic=today\n```\nWe get something like this in the browser window:\n\n\n\nAll-Time Statistics:\n```\npomodoro --statistic=all\n```\nWe get something like this in the browser window:\n\n\nDelete (clear) statistics for today:\n```\npomodoro --statistic=delete-today\n```\nDelete (clear) all statistics:\n```\npomodoro --statistic=delete-all\n```\n\n## Requirements:\nSee in requirements.txt\n\n**pomodorotimer** works with python 3.10.13 or higher.\n\n\n## How uninstall **pomodorotimer** \ud83d\ude2d:\n```\npip uninstall pomodorotimer\n```\n\n## Licence:\n\n\n## Authors:\n\n**Alexey Patsukov \ud83c\uddf7\ud83c\uddfa** - [GitHub profile](https://github.com/patsuckow)\n\n### Submit issues\n\nIf you spotted something weird in application behavior or want to propose a \nfeature you are welcome.\n\n### Write code\n\nIf you are eager to participate in application development and to work on an \nexisting issue (whether it should\nbe a bugfix or a feature implementation), fork, write code, and make a pull \nrequest right from the forked project page.\n\n### Spread the word\n\nIf you have some tips and tricks or any other words that you think might be of \ninterest for the others \u2014 publish it\nwherever you find convenient.\n\nRead also:\n- https://francescocirillo.com\n- https://habr.com/ru/post/446996/\n- http://career-philol.ru/page/adaptive/id341091/blog/3189767/\n",
"bugtrack_url": null,
"license": "GNU General Public License v3 (GPLv3)",
"summary": "CLI Pomodoro Timer",
"version": "0.2.4",
"project_urls": {
"Bug Tracker": "https://github.com/patsuckow/pomodorotimer/issues",
"Donate": "https://www.paypal.me/patsuckow",
"Homepage": "https://github.com/patsuckow/pomodorotimer"
},
"split_keywords": [
"pomodoro",
"tomato",
"pomodorotimer",
"pomodoro timer",
"pomodoro technique",
"productivity",
"time management",
"countdown",
"stopwatch",
"timer",
"eta",
"freelance",
"freelancing",
"cli"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f1f9af58931a4224ec9b5bd6076a8218055e69315ccf2d7e2ad3e33b1e2b7a71",
"md5": "aa5668a88007d3826ca4ef8d73670b73",
"sha256": "9d0adc8103fe0438ca16cceef4261d8eaebe46dd9c04bd5bfb88ee15269a5609"
},
"downloads": -1,
"filename": "pomodorotimer-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aa5668a88007d3826ca4ef8d73670b73",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10.13",
"size": 208277,
"upload_time": "2023-12-18T14:46:03",
"upload_time_iso_8601": "2023-12-18T14:46:03.865716Z",
"url": "https://files.pythonhosted.org/packages/f1/f9/af58931a4224ec9b5bd6076a8218055e69315ccf2d7e2ad3e33b1e2b7a71/pomodorotimer-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8c84a99d39526f592a29d17b492c88e4042867fbc60ce0982de10544c7622519",
"md5": "99d96a243027523bf7641163a7157dca",
"sha256": "738ac7cc32e4be06aadb2714087c481262eb5a41962b31854d80ea59f0042fec"
},
"downloads": -1,
"filename": "pomodorotimer-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "99d96a243027523bf7641163a7157dca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10.13",
"size": 209179,
"upload_time": "2023-12-18T14:46:07",
"upload_time_iso_8601": "2023-12-18T14:46:07.011731Z",
"url": "https://files.pythonhosted.org/packages/8c/84/a99d39526f592a29d17b492c88e4042867fbc60ce0982de10544c7622519/pomodorotimer-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-18 14:46:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "patsuckow",
"github_project": "pomodorotimer",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "pomodorotimer"
}
JSON
