Need help with timeloop?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

182 Stars 40 Forks MIT License 13 Commits 17 Opened issues


An elegant periodic task executor

Services available


Need anything else?

Contributors list


Timeloop is a service that can be used to run periodic tasks after a certain interval.

Each job runs on a separate thread and when the service is shut down, it waits till all tasks currently being executed are completed.

Inspired by this blog



pip install timeloop

Writing jobs

import time

from timeloop import Timeloop from datetime import timedelta

tl = Timeloop()

@tl.job(interval=timedelta(seconds=2)) def sample_job_every_2s(): print "2s job current time : {}".format(time.ctime())

@tl.job(interval=timedelta(seconds=5)) def sample_job_every_5s(): print "5s job current time : {}".format(time.ctime())

@tl.job(interval=timedelta(seconds=10)) def sample_job_every_10s(): print "10s job current time : {}".format(time.ctime())

Start time loop in separate thread

By default timeloop starts in a separate thread.

Please do not forget to call

before exiting the program, Or else the jobs wont shut down gracefully.

while True: try: time.sleep(1) except KeyboardInterrupt: tl.stop() break

Start time loop in main thread

Doing this will automatically shut down the jobs gracefully when the program is killed, so no need to call



  • Sankalp Jonna

Email me with any queries: s[email protected].

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.