FAQ

Sub-Zero is not visible among the channels

Most likely, channel mode has been disabled. See EnableChannel If so, go to Settings/Agents of your server, and select the Movies/Plex Movie tab. In there, you'll find an entry for Sub-Zero, and can press the gear icon to launch the settings of it

I'm running the plugin for the first time and want to have subtitles for all of my old items

In your Plex library press the little cog and select "Refresh All Metadata" (more info). This will re-download the library's metadata (e.g. posters, descriptions, subtitles, and other info) from the internet. Note that large libraries might run into API usage limits imposed by the various subtitle provider websites, you will just need to be patient until the scheduler runs another full search.

Sub-Zero complains about permissions

your library folders should be writable by the user your Plex server runs as

• to make your PMS user own your example library folder /path/to/library
• run chown -R `ps aux |grep -m1 com.plexapp.system |cut -f1 -d " " /path/to/library`
• while your PMS is running, on your own risk

After I install Sub-Zero it finds some but not all subtitles for my media

You might be hitting rate-limits if you search a large library

Sub-Zero Reports "Please enable me; currently I do nothing"

Locate your Plex Meta-Data Agents settings, and you will see a new source available for Sub-Zero. As of writing, this Sub-Zero meta-data source is found on libraries of type "Movies" or "Shows". See this page for more info

Sub-Zero doesn't find any or wrong subtitles for my media

Although SZ tries to be smart, folder/file-naming may be your issue. See How Matching Works for more info.

Also you may want to adjust the scoring system.

Where are the logs

See Logs

What is the "I keep the exact release title" setting?

It's a special case for OpenSubtitles. They support matching for an exact filename (they call it tag match). When the option is turned on, SZ also tries the exact match (in addition to a hash based match), and if found, scores it the same as an exact hash match.

Turning this on should not have a big negative effect if you have some renamed files.

But consider this: You've got release name Blabla.2015.x264-GROUP.mkv and you rename it to Blabla.mkv. SZ searches for that filename on OpenSubtitles and some other dude (there are many of them) have added it as an alternative filename for his/her subtitle - you'll most likely get that subtitle because it's being treated with the highest possible score. But as the tag match is treated the same as a hash match, the sanity checks are applied as well, which may help enough to not get any wrong subtitles.

Due to the nature of OpenSubtitles one can add Moviename Blabla Subtitle HEHEHE as a subtitle name and specify multiple movie hashes, and alternative file names (tags), which may match your local file. The feature was added because Sub-Zero can't determine enough info from Moviename Blabla Subtitle HEHEHE because the uploader was lazy, but it may find the full filename in the alternative names list.

DistributionNotFound Error

Your PythonPath may include your system python.
Please follow this to fix the issue.

Back to main page