An ncurses stopwatch/timer.
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.



chronos is an ncurses stopwatch/timer. It supports multiple simultaneous timers, which makes it ideal for keeping track of time spent on various tasks.

Show me the goods

Okay, how do I use it?


From the command line:

pip install chronos

If chronos is already installed, you can upgrade to the latest version with:

pip install --upgrade chronos


To use chronos, run it from the command line:



The following commands are supported:

n - Creates and starts a new timer.
j - Move cursor down.
k - Move cursor up.
d - Deletes the selected timer.
e - Edits the title of the selected timer.
p - Pauses/starts the selected timer.
r - Resets the selected timer.
a - Adds time to the selected timer.
s - Subtracts time from the selected timer.
q - Quits the program.
h - Shows the help screen.

Adding and Subtracting Time

When entering the amount of time to add or subtract, you can use any combination of the following formats:

xh - x number of hours
ym - y number of minutes
zs - z number of seconds

So if you wanted to add/subtract 1 hour and 5 minutes, type:


Or if you wanted to add/subtract 45 minutes and 30 seconds, type:


Version Information

Current stable release is v0.3, last updated on 1 May 2015.


Feel free to send any feedback you may have regarding this project to