Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A pure-python periodic timer that can be started multiple times

Project description


A pure-python auto-repeating timer that can be stopped and restarted multiple times.

multitimer.MultiTimer is similar to threading.Timer, but allows the timer to repeat multiple times. Additionally, MultiTimer can be started and stopped multiple times (unlike threading.Timer).


multitimer.MultiTimer(interval, function, args=None, kwargs=None, count=-1, runonstart=True)

Creates a timer that will run function with arguments args and keyword arguments kwargs, after interval seconds have passed, a total of count times.

If runonstart==True, then function will be called immediately when .start() is called.

If args is None (the default) then an empty list will be used. If kwargs is None (the default) then an empty dict will be used.

If count == -1 (the default), the timer will repeat indefinitely, or until .stop() is called.

Start this timer by calling .start(). Once started, calling .stop() will terminate the timer's loop and not produce any further calls to function. Note that if function is currently in the middle of running, it will finish the current iteration and not be interrupted.

ontimeout and params are deprecated in 0.2, and replaced by function, args and kwargs, to match the threading.Timer API.

Since the underlying mechanism is purely based on python threads & events, the overall processor load & memory usage are minimal. Note that the timing accuracy is typically to within about 10 ms, depending on the platform.

Installation & usage

$ pip install multitimer
import multitimer
import time

def job():
	print("I'm working...")

# This timer will run job() five times, one second apart
timer = multitimer.MultiTimer(interval=1, function=job, count=5)

# Pauses for one interval before starting job() five times
timer = multitimer.MultiTimer(interval=1, function=job, count=5, runonstart=False)

# You can specify input parameters for the _function_ function
def job2(foo):

timer = multitimer.MultiTimer(interval=1, function=job2, kwargs={'foo':"I'm still working..."})

# Also, this timer would run indefinitely...

# ...unless it gets stopped

# If a mutable object is used to specify input parameters, it can be changed after starting the timer
output = {'foo':"Doin' my job again."}
timer = multitimer.MultiTimer(interval=1, function=job2, kwargs=output, count=5)

output['foo'] = "I'd like to be done now."

# And a MultiTimer can be re-started by just calling start() again
output['foo'] = 'Please just let me be...'


0.1, 2018-02-15

  • Initial release

0.2, 2019-01-17

  • Replace time.clock() calls with time.perf_counter(), as time.clock is deprecated since python 3.3 and doesn't provide consistent behavior across different platforms.
  • Replace ontimeout with function, and params with args and kwargs, to match the threading.Timer API. ontimeout and params are deprecated and will be removed in v0.3.
  • Added lots of code comments to better explain how the module works.


Josh Burnett -

Distributed under the MIT license. See LICENSE.txt for more information.

Hope you find this useful!

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for multitimer, version 0.2
Filename, size File type Python version Upload date Hashes
Filename, size multitimer-0.2-py2.py3-none-any.whl (5.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size (12.6 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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page