Skip to main content

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.

Initial Setup

First you must connect to your slot via ssh. If you need help connecting to the server, please read the help article here.

Installing Bazarr is easy. Simply issue the following command:

box install bazarr

This command will configure bazarr for your user.

How to Access

On initial launch it is critical that you use the same login credentials AND set authentication to "Forms based" logins when asked to setup credentials!

Once setup, bazarr will be available at the link https://<hostname.io>/bazarr

Service Management

Like all box configured applications, you can manage Bazarr via SSH with box with start, stop, restart, enable and disable commands.

box start bazarr

Configuration

You'll need to do a bit of configuration to setup Bazarr with your subtitle providers; however, if you installed Sonarr and/or Radarr prior to installing Bazarr, we've done our best to streamline the configuration process by pre-configuring the connections to these apps for you.

First run

If you've already got Sonarr or Radarr installed, you'll skip the setup wizard. Nifty!

You'll still need to setup your subtitles provider. Go to Settings > Subtitles. Select a provider, enter your credentials. Scroll down the page to Subtitle Languages and add your preferred languages. Click Save. Bazarr should now be ready to go!

If you haven't installed Sonarr or Radarr yet, you'll be greeted by a setup wizard. You shouldn't need to edit any details on the General page; however, if the URL Base field is empty, make sure you enter: /bazarr/ (note the leading and trailing slashes). Click Next.

On the Subtitles page, choose a provider and set at least one language. You won't be able to proceed with the wizard until you've set these basics.

Connect to *darr apps

If Sonarr or Radarr weren't setup when you installed, you can still manually configure the connection to these apps. To add a media client, go to Settings > Sonarr or Settings > Radarr.

Sonarr

IP: <subnet IP>
Port: <sonarr port>
Base URL: /sonarr
API Key: <sonarr API>

Radarr

IP: <subnet IP>
Port: <radarr port>
Base URL: /radarr
API Key: <radarr API>
Tip

Forgot your subnet, API key or port? No worries, here are oneliners you can submit from SSH:

Subnet:

cat ~/.install/subnet.lock

Sonarr:

cat ~/.config/Sonarr/config.xml | grep -e \<Api -e \<Port

Radarr:

cat ~/.config/Radarr/config.xml | grep -e \<Api -e \<Port

More info

If you need further help, please refer to the Bazarr Wiki.