Skip to content

Settings

THIS SECTION IS OUTDATED AND STILL NEEDS TO GET UPDATED !!!

General

Host

image-20200723194801432

Bind Address

Valid IP4 address or '0.0.0.0' for all interfaces

Leave it as 0.0.0.0 if you want to listen on every available IP address (recommended). If you are running inside a docker container, that's the recommended value.

Port Number

Should be an available TCP port on the computer running Bazarr. Default is 6767 and it is the recommended value.

URL Base

This option gives you the opportunity to serve Bazarr in a sub-directory. Ex.: http://127.0.0.1:6767/bazarr/ instead of the default http://127.0.0.1:6767/

Mainly used when you use a reverse proxy, if you don't use a reverse proxy or don't know what it is leave this empty!!!

Security

image-20200723195938008

Authentication

Select the type of authentication process desired from basic (browser popup) or forms login. Be aware that basic auth is not secure if not used in conjunction with SSL (using a reverse proxy).

Username

Enter here the username to access Bazarr.

Password

Enter here the password to access Bazarr.

API Key

Your API Key.

Proxy

image-20200723200207185

Type

Select the desired proxy type from HTTP(S), Socks4 or Socks5.

Hostname

Enter here the hostname of your proxy.

Port

Enter here the TCP port of your proxy.

Username-

Enter here the username (if required) to authenticate to your proxy.

Password-

Enter here the password (if required) to authenticate to your proxy.

Ignored addresses

Enter here (if required), a list of comma separated hostname or IPv4 addresses to be excluded from going through the proxy.

UI

image-20200723200359127

Self explanatory.

Logging

image-20200723200459213

This option enables debug logging and should be enabled for a short period to facilitate debugging process.

Analytics

image-20200723200850798

Send anonymous usage information, nothing that can identify you. This includes information on which providers you use, what languages you search for, Bazarr, Python, Sonarr, Radarr and what OS version you are using. We will use this information to prioritize features and bug fixes. Please, keep this enabled as this is the only way we have to better understand how you use Bazarr.


Sonarr

Host-

image-20200520223746802

Hostname or IP address

Enter the hostname or the IP address of the computer running your Sonarr instance.

Be aware that when using Bazarr in docker, you cannot reach another container on the same Docker host using the loopback address (ex.: 127.0.0.1 or localhost). Loopback address refer to the Bazarr Docker container, not the Docker host.

Port Number-

Enter the TCP port of your Sonarr instance. Default is 8989.

URL Base-

Mainly used by those who expose Sonarr behind a reverse proxy (ex.: /sonarr). Don't forget the leading slash. In fact, it should look exactly the same as in Sonarr settings. Mainly used when you use a reverse proxy.

If you don't use a reverse proxy or don't know what it is leave this empty !!!

SSL enabled

Enable this if your Sonarr instance is exposed trough SSL.

Not needed if you reach it with a local IP address.

API key

Enter your Sonarr API key here.

Click the Test button after filling in all the fields. Make sure the test is successful before you proceed.

Options

image-20200723142916426

Minimum Score

Select the minimal score (in percentage) required for a subtitles file to be downloaded. Are your subs often out of sync? Raise the score!

Download Only Monitored

Automatic download of Subtitles will only happen for monitored shows/episodes in Sonarr.

Excluded Tags

Episodes from series with those tags (case sensitive) in Sonarr will be excluded from automatic download of Subtitles. In Sonarr you add a custom made tag to a show, in this case the shows with these tags will be ignored by Bazarr. examples: dutch, anime

Excluded Series Types

Episodes from series with those types in Sonarr will be excluded from automatic download of Subtitles. Options: Standard, Anime, Daily

Path Mappings

image-20200723144000147

You should only use this section if Sonarr and Bazarr use a different path to access the same episode file (.mkv). (for example if you run Sonarr on a different device then Bazarr or have a Synology and mix packages with Docker.)

animated-exclamation-mark-image-0006

IF YOU GOT THE SAME VALUES ON BOTH SIDES THEN YOU DON'T NEED IT !!! IT SHOULD ALSO BE REMOVED OR ELSE YOU WILL GET A ERROR.

animated-exclamation-mark-image-0006

Click on Add and you will get a popup window image-20200724211005207

Ex.:

  • Browse or type the path for Sonarr: /media/tv_shows/seriesX/
  • Browse or type the path for Bazarr: `\nas\tv\seriesX\

The common part of both path can be discarded and you should use those values:

  • Path for Sonarr: /media/tv_shows/
  • Path for Bazarr: \\nas\tv\

If everything runs on Docker you normally don't need to use this. Except if you have messed up path mappings and then it would be smarter to fix those first to have consistency and well planned paths.


Radarr

The same setup as you did for Sonarr except for the default Port Number: 7878


Subtitles

Subtitles Options

image-20200723205858233

Subtitle Folder

Choose the location where you want your subtitles to be stored, Alongside Media File is the recommended value.

Upgrade Previously Downloaded Subtitles

Schedule a task to upgrade Subtitles previously downloaded by Bazarr.

Number of days to go back in history to upgrade subtitles (up to 30)

Number of days to go back in history to upgrade Subtitles (up to 30).

Upgrade Manually Downloaded Subtitles

Enable or disable the upgrade of manually searched and downloaded subtitles.

Anti-Captcha Options

Some providers require a Anti-Captcha when using their API.

image-20200723180451078

Choose the Anti-Captcha provider you want to use. and add the necessary credentials.

We recommend Anti-Captcha.com.

Performance / Optimization

image-20200723211755850

Adaptive Searching

When enabled, Bazarr will search less frequently to limit API calls to providers. This option enables search on a weekly basis for episodes or movies that are unsuccessful after 4 weeks.

Search Enabled Providers Simultaneously

Search multiple providers at once (Don't choose this on low powered devices)

Use Embedded Subtitles

When disabled, this option forces Bazarr to not take care of embedded subtitles when deciding if a language is missing.

When enabled you several extra options

image-20200725150727044

Ignore Embedded PGS Subtitles

When enabled it Ignores PGS Subtitles in Embedded Subtitles detection. Only relevant if Use embedded Subtitles is enabled.

Show Only Desired Languages

When enabled it hides embedded subtitles for languages that are not wanted.

Post-Processing

image-20200723212422568

Encode Subtitles To UTF8

Re-encode downloaded Subtitles to UTF8. Should be left enabled in most cases.

Enable CHMOD

This option,it is only available on *nix based operating systems, gives the possibility to set permissions on subtitle files created by Bazarr.

Subtitles synchronization

Enable the subtitles synchronization after downloading a subtitles.

Subtitles synchronization score threshold for series

Only synchronize the subtitles if the score is below your chosen score.

Subtitles synchronization score threshold for movies

Only synchronize the subtitles if the score is below your chosen score.

Use Custom Post-Processing

image-20200723213106103

Use Custom Post-Processing-

Enable the post-processing execution after downloading a subtitles.

Post-processing score threshold for series

Only runs Post-processing if the score is below your chosen score.

Post-processing score threshold for movies

Only runs Post-processing if the score is below your chosen score.

Post-processing command

Enter in this field the script or binary path to execute with the desired arguments. Please be aware that double-quote could be necessary around arguments.

Be aware that your command cannot start or end with quote/double-quote. You must append something like 2>&1 to the end of your command.


Languages

Subtitles Languages

image-20200520233329803

Single Language

We don't recommend enabling this option unless absolutely required (ie: media player not supporting language code in subtitles filename). Be aware the language code (ex.: en) is not going to be included in the subtitles file name when enabling this.

Recommended value is off

Enabled Languages

Select the languages you want to be able to use in Bazarr. This doesn't add any required languages to series or movies, it just filter out the language list everywhere in the UI to have a more readable drop-down.

Default Settings

image-20200520234444241

Series Default Setting

Enable the automatic selection of desired languages for new series added after the activation of this option.

Languages-

Select the languages to be added to required languages for new series.

Hearing-impaired

Enable this to require hearing-impaired subtitles instead of standard one.

Forced

Forced subtitles are the subtitles appearing on screen when the characters speak a foreign or alien language, or there is a sign, location, or other text in the scene.

  • Like Dothraki in Game of Thrones.
  • Star Trek when someone speaks Klingon.

Values:

  • False: Search for normal subtitles.
  • True: Search for only forced subtitles. (keep in mind that forced subs aren't available in every languages and are hard to find).
  • Both: Search for normal subtitles and forced subtitles.
Movies Default Setting

Same as for series.


Providers

image-20200520235129443

Select the subtitles providers you would like to enable. It is best to select multiple providers and create/use a account with them especially when you have a lot of wanted subtitles. Some subtitle providers requires a extra paid Anti-Captcha Service.

If possible don't forget to support them for their free service


Notifications

For each notification provider, you need to enable (if desired) and, in the corresponding input field, provide a valid config string as described in Apprise wiki.


Scheduler

Sonarr/Radarr Sync

image-20200724144801431

Update Series list from Sonarr

How often to sync with Sonarr for new Series

Update Episodes list from Sonarr

How often to sync with Sonarr for new Episodes

Update Movies list from Radarr

How often to sync with Radarr for new Movies

Disk Indexing

image-20200724145153311

Update all Episode Subtitles from disk

How often should Bazarr Update all Episodes Subtitles from disk

  • Daily
  • Weekly
  • Manually
Day of the week

Which day of the week

Hour of the day

Which hour of the day

Update all Movie Subtitles from disk

Same as series

Search and Upgrade Subtitles

image-20200724145514902

Search for Missing Series Subtitles

How often should Bazarr Search for Missing Series Subtitles

Search for Missing Movies Subtitles

How often should Bazarr Search for Missing Movies Subtitles

Upgrade previously downloaded Subtitles

How often should Bazarr upgrade previously downloaded Subtitles