FAQ
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
In your library sidebar press the three dots 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 and run the refresh multiple times over a couple of days.
Your library folders should be writable by the user your Plex server runs as.
- make sure your PMS system user owns your example library folder
/path/to/libraryor - make sure your PMS system user shares a common group with your downloaders that manage your library folders, and the libraries are chmod 775
If running QuickBox, then:
- In a terminal, type:
apt-get install acl - Then Follow
You might be hitting rate-limits if you search a large library
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
Although SZ tries to be smart, folder/file-naming may be your issue. See How Matching Works for more info. If you use software to rename your media files, be sure to read up on Refiners.
Also you may want to adjust the scoring system.
See Logs
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.
Your PythonPath may include your system python.
Please follow this to fix the issue.
Be sure to set your Addic7ed account's language settings to all.
Before that task does anything, SZ needs to "know" about your items by creating an empty subtitle storage information for them. In order for this to happen, please refresh your library metadata once.
Q11: I've changed the primary metadata agent for my library and now my old movies don't get any subtitles
Changing the primary metadata provider for your library doesn't change the provider used when an item was added to the library. Either enable SZ for the old primary metadata agent as well, or break down the library and re-create it.
Sub-Zero was created by pannal if you like it, then consider buying him a beer!
or join Sub-Zero Patreon starting at 1 $ / month:
