Skip to main content

Intelligent interface to cron in UNIX systems

Project description


Run pip install supercron or easy_install supercron.

SuperCron vs classical crontab

SuperCron is based on crontab, while providing the following additional advantages:

  • it can run interactively or non-interactively.
  • it allows controlling several jobs simultaneously if they were assigned the same job name.
  • it provides more options to handle jobs: adding, removing, searching, enabling, disabling, etc.
  • it allows a vast and flexible amount of repetition sentences.
  • it is more friendly especially to new sysadmins.


SuperCron can run either in interactive mode or non-interactive mode.

Interactive mode:

Run supercron without any arguments to start interactive mode. You will prompted to choose an action, and then to enter action parameters (like name, command and repetition) if any.

Non-interactive mode:

In non-interactive mode, at least one of the following options/arguments has to be used after the command name supercron.

  • option -h or --help: shows the help message, with some usage examples
  • option -V or --version: displays the version number

Additionally, one of the following subcommands can be used: add, delete, enable, disable, search, clear.

Subcommand add

  • option -h or --help: shows the help message of the subcommand
  • option -q or --quiet: optional; suppresses all output and error messages
  • option -c or --command: required; here goes the command to be executed
  • option -r or --repetition: required; the repetition sentence (see examples below)
  • argument name: required; represents the job name which will be added (several jobs can share the same name)

Subcommands delete, enable and disable

  • option -h or --help: shows the help message of the subcommand
  • option -q or --quiet: optional; suppresses all output and error messages
  • argument name: required; represents the job name on which the action will occur (several jobs can share the same name)

*Subcommand search*

  • option -h or --help: shows the help message of the subcommand
  • argument name: required; the exact job name to search for, or @supercron to list all SuperCron jobs, or @all to list all user’s crontab entries

*Subcommand clear*

It will only clear SuperCron jobs from user’s crontab:

  • option -h or --help: shows the help message of the subcommand
  • option -f or --force: skips asking for confirmation before clearing all jobs


  • Add a job:

    supercron add -c "date +%j >> log_file" -r "every 2 days" log_dates
    supercron add -c "scp -r /path1 user@server:/path2" -r "at 11:50 pm on mondays" backup_server
  • Delete a job:

    supercron delete log_dates
  • Enable a job:

    supercron enable log_dates
  • Disable a job:

    supercron disable log_dates
  • Search jobs:

    supercron search log_dates
    supercron search @supercron
    supercron search @all
  • Clear all SuperCron jobs:

    supercron clear

Repetition sentences

Repetition sentences are provided in a supercron add command directly after the -r or --repetition option.

Examples of accepted repetition sentences (case insensitive):

  • everyday
  • at midnight
  • every 5 minutes
  • once every 2 hours
  • every 10 days
  • every 4 months
  • on mondays
  • on monday, wednesday and friday
  • from saturday to tuesday
  • on fri
  • on mon, wed and fri
  • from mon to thu
  • at 11:50
  • at 23:50
  • at 10:10 am
  • at 10:10 pm
  • on 19/5
  • in september
  • in sep
  • from may to august
  • from dec to feb
  • in january and april
  • in jan, aug, oct

Repetition sentences can also be any (unsorted) logical mix of the above. For example:

  • at 09:00 every 3 days
  • from june to november every 2 hours
  • every 30 minutes on fri and sat
  • midnight from monday to friday in october and december

Homepage and Repository



License and Authors

This software is licensed under the revised BSD license.


  • Anas El Husseini (linux.anas [at] gmail [dot] com)

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 supercron, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size supercron-0.2.2.tar.gz (11.0 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