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

Wiki > Bazarr

Bazarr is a companion application to Sonarr and Radarr. It manages and downloads subtitles based on your requirements. You define your preferences by TV show or movie and Bazarr takes care of everything for you.


Custom installations of Bazarr do not have authentication enabled by default! You must follow all of the installation instructions or Bazarr will be publicly accessible, including full file system access.
  1. Connect to your slot through SSH

  2. Create a Python 3 virtualenv with the instructions found here or use an existing one.

  3. Download the latest version of Bazarr

     wget https://github.com/morpheus65535/bazarr/releases/latest/download/bazarr.zip
  4. Extract the latest version of Bazarr

     unzip -d ~/bazarr bazarr.zip
  5. Activate your Python 3 virtualenv if it is not already active. If you are using a different directory for your virtualenv, use that directory instead.

    source ~/virtualenv/bin/activate
  6. Change your directory

     cd ~/bazarr
  7. Install bazarr's Python dependencies

     pip install -r requirements.txt
  8. Launch Bazarr. Port 19707 has been automatically generated for you, but you may use another 5 digit port between 10000 and 65535.

     screen -dmS bazarr ~/virtualenv/bin/python3 ~/bazarr/bazarr.py -p 19707

Access Bazarr at http://server.whatbox.ca:19707 and follow the configuration wizard. Once Bazarr is configured, click on the link near the top of the page to restart Bazarr.

IMPORTANT: Click on Settings and change Authentication to Forms (Login Page). Add a username and password you wish to use to access Bazarr. Click the Save button at the top of the page and then click the link to restart Bazarr again. You will be redirected to the login page where you can login with the username and password you provided.

To update Bazarr, shut down Bazarr with pkill -f bazarr then follow the installation instructions again.

Automatically restart

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

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

     if pgrep -fx "/home/user/virtualenv/bin/python3 /home/user/bazarr/bazarr.py -p 19707" > /dev/null
         echo "bazarr is running."
         echo "bazarr is not running, starting bazarr"
         screen -dmS bazarr /home/user/virtualenv/bin/python3 /home/user/bazarr/bazarr.py -p 19707
  3. Save the file with Ctrl+x and the "y" and Enter to accept overwriting.

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

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

  6. Enter the following text

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