Skip to main content

An ncurses stopwatch/timer.

Project description


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



  • Add support for window resizing and scrolling (GH-4)


  • Overhaul the UI and improve the UX


  • Implement functionality to add and subtract time (GH-2)


  • Change xterm-color to xterm to support curs_set(0) (GH-1)


  • Initial release

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 (10.9 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page