Whatbox Logo
Login for certain variables to be updated with your slot's information

Wiki > SickChill

Automatic Video Library Manager for TV Shows. It watches for new episodes of your favorite shows, and when they are posted it does its magic. Development hosted on GitHub.



Follow the instructions in the virtualenv article to install and activate a Python 3 virtual environment. If you have previously set up a virtualenv, you may choose to re-use it or create a new one with a different name.


  1. With your virtualenv activated, install SickChill

     pip install sickchill
  2. Start SickChill in daemon mode to create the initial configuration files.

     SickChill -d --nolaunch

    When timestamps start appearing, press Ctrl+C to shutdown SickChill. If the program closes, start it again until timestamps appear.

  3. Edit the configuration file to set the required settings. A username and password must be set. Port 19773 has been automatically generated for you, but you may use another 5 digit port between 10000 and 32768.

     nano ~/sickchill/config.ini

    Change the line that reads root_dirs = "" to root_dirs = "0|/home/user/files".
    Change the "web_port" option to 19773 or your chosen port. Set a username and password for the web interface by editing web_username = "user" and web_password = "your password here"

  4. Change Your Bash Timezone. If you haven't set your Bash Timezone, your logs and television schedule will be incorrect.

  5. Restart Sickbeard

     SickChill -d

Node.js (optional)

Node.js is required for certain search providers to function properly. Complete only the installation section.

Automatically Restart

Below are steps to take to have your SickChill instance automatically restart if it crashes, or if the server is rebooted.

  1. Make a file to be used for the script. touch ~/sickchill_restart.cron

  2. Edit the file and enter the text below. nano -w ~/sickchill_restart.cron

    if pgrep -f "SickChill -d" > /dev/null
        echo "SickChill is running."
        echo "SickChill is not running, starting SickChill"
         ~/virtualenv3/bin/python ~/virtualenv3/bin/SickChill -d
  3. Save the file with Ctrl+x, y and Enter to accept overwriting.

  4. Make the script executable. chmod +x ~/sickchill_restart.cron

  5. Open your crontab. EDITOR=nano crontab -e

  6. Enter the following text at the end of the file.

    @reboot /home/user/sickchill_restart.cron >/dev/null 2>&1
    */5 * * * * /home/user/sickchill_restart.cron >/dev/null 2>&1
  7. Save the crontab with Ctrl+x, y and Enter to accept overwriting.


  • Open your browser and navigate to http://server.whatbox.ca:19773 to access the SickChill web interface.