The SubtitleProvider (SP for short) Plugin adds automatic subtitle downloading to Media Brower and is created by Miksu. This plugin is currently under active development, so it’s possible that the information here is a bit outdated.

• You can get the plugin here.
• Plugin Installation instructions can be found here

---

Configuration options

After you've downloaded and installed the plugin, there are a few things you need to configure.

On the Plugins tab, highlight the Subtitle Provider plugin and click the Configure button. A new window will appear.

• Languages – Enter the languages you want SP to download seperated by a comma (,). The first language has top priority with additional languages as fallback.
• Disable automatic dl – If you have Internet Providers enabled in Media Browser, this will disable the automatic processing of SubtitleProvider, leaving only the manual functions of SP.

---

How it works

The SP plugin can work in several different ways.

If you have Internet Providers enabled in Media Browser:

• the plugin will automatically scan you media collections, download subtitles in the configured languages, unzip and rename them according to the media file name.
• you can perform a manual check and let the plugin download subtitles, by pressing the Refresh button. SP will then do it’s thing on the current item.
• If there is a subtitle file present (.srt or .sub) in a movie folder, the plugin will skip it.

If you don’t use Internet Providers:

• SubtitleProvider also offers Context-Menu items.
• You can check to see if there is a subtitle present for a movie. A popup window will appear stating that a subtitle is present or not. If no subtitle is present, you can let SP check to see if there is one available online and download it if present. If a subtitle is already present, SubtitleProvider offers you to blacklist the current subtitle and download a new one that is not blacklisted. More information about the blacklisting future can be found below.
• the Refresh button does not work if Internet Providers are disabled.

---

Blacklisting Subtitles:

Blacklisting is based on the urls. SubtitleProvider keeps track of the downloaded subtitle files (in C:\ProgramData\MediaBrowser\Plugins\subtitles\list.xml). When the plugin downloads a subtitle, it stores the download location’s url. If one then blacklists the subtitle, that url is marked as invalid.

Blacklisting contains these phases:

1. Ask if the user wants to blacklist the current subtitle
2. Mark the current subtitle as invalid
3. Search for new subtitle files
4. Download the first one which isn’t blacklisted
5. Overwrite the old subtitle with a new one

This means that the blacklisted subtitle is only deleted if a new subtitle file is successfully downloaded.

Note: Subtitle blacklisting only works with subtitles which have been downloaded with SubtitleProvider v1.0 (or newer).

---

Additional information

• Currently the plugin will only work automatically if you have Internet Providers enabled in Media Browser. Otherwise you will need to use the context menu option.

===

We need your feedback. This topic needs improvements. please use the improve link below.