Skip to main content

Timer (stopwatch and countdown) widgets for tkinter

Project description


tktimer is a set of tkinter widgets including a Stopwatch widget and a Countdown widget.


$ pip install tktimer


The timers have two methods: start() and pause().

You can find example programs in examples/.

Available options:

option description default
parent set the parent widget.
prefix set text before timer value. ""
suffix set text after timer value. ""
unit set the unit (available: second, minute, hour, day, week, year). second
beginning set starting point (in seconds). specific to Countdown. 10
update_every set updating time every X milliseconds. 10
precision set counting precision (number of digits after the decimal point). 2
offset set time offset (in seconds). specific to Stopwatch. 10


How can I continue the timer after restarting my app?

You can get the elapsed time (in seconds) with timer.value.get() on exit and set offset later on, which will make the timer start counting from offset. For Countdown, tweak beginning instead of offset.

I'm not happy with how my timer looks like. Can I change its appearance?

Yes, timers are ultimately just tkinter labels which means you can do anything you would to an ordinary tkinter.Label.


Licensed under the MIT License. For details, see LICENSE.

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 tktimer, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size tktimer-0.1.0-py3-none-any.whl (3.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size tktimer-0.1.0.tar.gz (3.5 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page