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.


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:

pip3 install pomodorotimer --user

From sources:

Alternatively you can install pomodorotimer from sources directory:

git clone https://github.com/patsuckow/pomodorotimer
cd pomodorotimer
pip3 install -r requirements.txt
pip3 install . --user
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 version or higher.

Licence:

GNU GPL v 3 0

Authors:

Alexey Patsukov 🇷🇺 - GitHub profile

Contributing:

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.

Help in the development of the project

If you want to help in the development of the project or just to thank the author, this can be done through PayPal: https://www.paypal.me/patsuckow

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.

Files for pomodorotimer, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size pomodorotimer-0.2.0-py3-none-any.whl (208.0 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size pomodorotimer-0.2.0.tar.gz (206.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page