Skip to content

nearlynithin/tokidoro

Repository files navigation

tokidoro

Pomodoro CLI

tokidoro is simple command-line tool that implements the famous pomodoro technique to improve focus and productivity.

Python

Installation

Alert! Dependency issues. Cloning the repository is recommended

pip install tokidoro

Features

  • Start/Stop the timer
  • Set duration of breaks/cycle dynamically.
  • Save your favourite configuration
  • PLAY any audio on completetion of each cycle

Usage

  • tokidoro start Start a timer with default configuration
  • -d Set the duration for pomodoro in minutes (int /float)
  • -sSet the duration for the short break in minutes (int /float)
  • -lSet the duration for the long break in minutes (int /float)
  • -a Change the audio by specifying the serial no. of the audio
  • -rNumber of times the audio repeats.
  • tokidoro showconfigdisplays the current configuration and the list of audio saved.
  • tokidoro configure Change and save the configuration

Customization

custom audio

If you want to add a custom audio, paste an mp3 file into the sounds directory located in the directory where the pip package is stored eg :

cd /home/<user>/.local/lib/python3.10/site-packages/tokidoro/sounds

About

A python CLI pomodoro timer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages