Skip to main content

CLI Pomodoro Timer

Project description

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: Donate via PayPal or Buy us a Cofee

Pomodoro Technique:

Pomodoro Technique - see

plan

We will use the traditional Pomodoro scheme:

technique

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:

1

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)

2

3

4 2

5 2

The type of push notification depends on your OS and the type of graphical shell used, for example:

Peek 2019-12-30 22-35

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:

stat-2

All-Time Statistics:

pomodoro --statistic=all

We get something like this in the browser window: all

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:

GNU GPL v 3 0

Authors:

Alexey Patsukov 🇷🇺 - GitHub profile

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:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pomodorotimer-0.2.4.tar.gz (209.2 kB view details)

Uploaded Source

Built Distribution

pomodorotimer-0.2.4-py3-none-any.whl (208.3 kB view details)

Uploaded Python 3

File details

Details for the file pomodorotimer-0.2.4.tar.gz.

File metadata

  • Download URL: pomodorotimer-0.2.4.tar.gz
  • Upload date:
  • Size: 209.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.7

File hashes

Hashes for pomodorotimer-0.2.4.tar.gz
Algorithm Hash digest
SHA256 738ac7cc32e4be06aadb2714087c481262eb5a41962b31854d80ea59f0042fec
MD5 99d96a243027523bf7641163a7157dca
BLAKE2b-256 8c84a99d39526f592a29d17b492c88e4042867fbc60ce0982de10544c7622519

See more details on using hashes here.

File details

Details for the file pomodorotimer-0.2.4-py3-none-any.whl.

File metadata

File hashes

Hashes for pomodorotimer-0.2.4-py3-none-any.whl
Algorithm Hash digest
SHA256 9d0adc8103fe0438ca16cceef4261d8eaebe46dd9c04bd5bfb88ee15269a5609
MD5 aa5668a88007d3826ca4ef8d73670b73
BLAKE2b-256 f1f9af58931a4224ec9b5bd6076a8218055e69315ccf2d7e2ad3e33b1e2b7a71

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page