Usage

$ pip install schedule-ng

import schedule_ng as schedule
import time

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

schedule.every(10).seconds.do(job)
schedule.every(10).minutes.do(job)
schedule.every().hour.do(job)
schedule.every().day.at("10:30").do(job)
schedule.every(5).to(10).minutes.do(job)
schedule.every().monday.do(job)
schedule.every().wednesday.at("13:15").do(job)
schedule.every().day.at("12:42", "Europe/Amsterdam").do(job)
schedule.every().minute.at(":17").do(job)

def job_with_argument(name):
    print(f"I am {name}")

schedule.every(10).seconds.do(job_with_argument, name="Peter")

while True:
    schedule.run_pending()
    time.sleep(1)

Documentation

schedule-ng’s documentation lives at schedule-ng.readthedocs.io.

Migrating from schedule

1. Replace schedule with schedule-ng in your dependencies.

2. Replace import schedule with import schedule_ng as schedule.

Behaviour, exceptions and the "schedule" logger name are unchanged. Any behavioural fix is listed in the changelog.

Why a fork?

schedule is used by millions of projects every month, but issues and pull requests have gone unanswered since 2024. This fork exists to keep it working on new Python versions, fix long-standing bugs and review the community’s pull requests, while keeping what made schedule popular: a small, simple, dependency-free API.

If the original project becomes active again, this fork will happily contribute its fixes back upstream.

Meta

Maintained by Adarssh Athithan. schedule was originally created by Daniel Bader. Thanks to him, Sijmen Huizenga and everyone listed in AUTHORS.rst for their work on it.

Please report problems with schedule-ng in its issue tracker, not to the original project.

Inspired by Adam Wiggins’ article “Rethinking Cron” and the clockwork Ruby module.

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