📘

Bazarr

Our search function may intermittently fail to display results. If this happens, try refreshing the page, as this usually resolves the issue. We’re working on a permanent fix. Thank you for your patience!

Bazarr

Bazarr is a companion application to Sonarr and Radarr that manages and downloads subtitles. Some of the features of this app are the following:

Downloads subtitles automatically using your set subtitle sources, languages, etc.
Automatically scans and upgrade previously downloaded subtitles.
Integration with Sonarr and Radarr.

Be aware that Bazarr doesn't scan your slot to detect series and movies: It only takes care of the series and movies indexed in Sonarr and Radarr.

In this guide, we'll be setting up Bazarr for the first time. This guide assumes the following:

You'll be setting up your library for the first time, and your library is saved locally under ~/media.
You have both Radarr and Sonarr installed and configured.

We'll be doing the following steps:

Set up subtitle providers.
Set Language Profile.
Connect Sonarr and Radarr.

Set Up Subtitle Providers

Upon successful installation, wait for up to 5 minutes for Bazarr to initialize.
After clicking Connect on the UCP, you'll be shown Bazarr's General settings.
On subtitles options section, Leave all options as-is.

Plex requires that subtitle files should be at the exact location as your movie file for it to be detected.
You may add the API key or account login for any anti-captcha service you may use on this page, included are Anti-Captcha or Death by Captcha If you happen to add one of these options, be sure to press Save in the top left-hand corner.

Then enable the subtitle providers that you wish to use. Click Providers on the left-hand side, tick your required providers, and click save to complete the providers' page.

Some providers require you to add your credentials. Be sure to enter it accordingly.
some providers need an anti-captcha API key.

Under languages on the left-hand side, click the drop-down box on enabled languages and select your preferred languages for Bazarr to search.
Then you can set the defaults for both Series and Movies.

Here, you can set the default parameters and languages that you wish to search and download.
You can leave them as default and set them later or do it now, as shown in the following screenshot.

Once that's done, click Next.

Set Language Profile

Go to Settings -> Languages
Choose the Language(s) you wish to have your subtitles in.
Click on Add New Profile.
Name the profile as per your preference.
Click on Add.

Here you can add multiple languages to form a list.

Set the Cutoff as per your preference. For more information visit here.
Click on Save.
Under Default Settings, check Series & Movies. For both of them, choose the profile you just created.
Click on Save in the top left.

Connect Sonarr and Radarr to Bazarr

Login to your Sonarr instance and go to Settings -> General.
Then under Security, copy the API key provided
Go back to Bazarr. Under Settings > Sonarr, enable Use Sonarr and input the following

Hostname or IP address: username.servername.usbx.me
Listening port: 443
Base URL: sonarr
SSL enabled: On
API Key: >paste Sonarr API key here<
Download Only Monitored: Enabled (Recommended)

Once that's done, click the Test button to validate the settings.
If it shows a green text indicating that Bazarr is successfully connected to Sonarr.
Repeat the same steps on Radarr, using the following information:

Hostname or IP address: username.servername.usbx.me
Listening port: 443
Base URL: radarr
SSL enabled: On
API Key: >paste Radarr API key here<
Download Only Monitored: Enabled (Recommended)

To get Radarr's API key, go to Settings > General and copy the API key under Security Settings.
Click Save to save your changes once testing is passed.

Download Subtitles

At initial setup, Bazarr will add your existing entries on your Sonarr/Radarr instances search for existing subtitles from their root folders. Both series/movie entries are found in Series and Movies, respectively.
If there are no entries on either of the two, you can force to refresh by going to System -> Tasks (Red Box) and click the Refresh icon on the following tasks in order.

Update Series list from Sonarr.
Update Movie list from Radarr.
Update all Episode Subtitles from disk.
Update all Movie Subtitles from disk.

Depending on the size of your library, this could take a while.
If everything is set, you can now download subtitles. You can opt to do the following.

Let Bazarr download the subtitles by itself. There's an automated task that downloads wanted subtitles daily.
Force Bazarr to download wanted subtitles by either.

Going to Wanted and click Search All on Series or Movies.

Go to System -> Tasks and click the following.

Update all Episode Subtitles from disk.
Update all Movie Subtitles from disk.

Depending on your library, this will take a while to search and download your subtitles.

If you require further assistance, you can open a support ticket here!

Feedback and suggestions regarding this article are welcome on our Discord server

Bazarr
Set Up Subtitle Providers
Set Language Profile
Connect Sonarr and Radarr to Bazarr
Download Subtitles