User Guide
When you are reading this page, we assume, that you already installed and configured Sub-Zero, and if not, then please do that first.
Create an account and provide your credentials if using the following providers in the plugin configuration for:
- Addic7ed
- Opensubtitles
- Legendas
- SubsCenter
When you first use this plugin and run a refresh on all of your media, you may be blacklisted out of excessive usage by some or all of the subtitle providers depending on your library's size. This will result in a bunch of errors in the log files as well as missing subtitles.
Just be patient, after a day most of those providers will allow you to access them again and you can refresh the remaining items. When you use the default settings, this will also skip the items it has already downloaded all the wanted languages for. Also, as subtitles will be missing, the scheduler should pick up the items with missing subtitles automatically.
Since 1.3.0 Sub-Zero not only comes as an agent plugin, but also has channel properties. By accessing the Sub-Zero channel you can get viable information about the scheduler state, search for missing subtitles, trigger forced-searches for individual items, and many more features yet to come.
To access the channel menu, start by selecting the Channel menu, followed by clicking on the image for Sub-Zero, and not the gear icon.
The Channel menu will then show, and we'll go through that in a few steps:
- On Deck Items
- shows On Deck media (returned by the Plex API, and only for the owner of the PMS), allowing you to manipulate the existing, or list available subtitles
- Recently-added Items
- same as above, but for Recently Added Items
- Items with missing subtitles
- search for items considered recent (See the Sub‐Zero Configuration menu)
- Browse all items
- start by selecting a library, and then media based on the alphabetically ordered list.
- after that, menu is as this
- start by selecting a library, and then media based on the alphabetically ordered list.
- Search for missing subtitles
- runs the search-for-missing-subtitles task manually. This normally runs periodically as configured via scheduler configuration.
- Display Ignore list
- lists all items currently in the Ignore list, and allowing you to remove it
- Display History of latest downloaded subtitles
- Refresh
- refresh the status of the Channel menu
- Advanced functions
- See Advanced usage
There are numerous occasions where one wouldn't want a certain item or even a library be included in the periodic Search for missing subtitles-task or the Items with missing subtitles menu function. Anime libraries are a good example of that, or home videos. Perhaps you've got your favorite series in your native language and don't want subtitles for it.
The ignore list can be managed by going through your library using the Browse all items menu and the Display ignore list menu.
The built-in scheduler is capable of running a number of tasks periodically in a separate Thread of the plugin. This currently is used to automatically periodically search for new and better subtitles for your media items. See Sub‐Zero Configuration
Sometimes subtitles aren't needed or wanted for parts of your library.
When a file named subzero.ignore, .subzero.ignore, or .nosz is found by the plugin in any of your library's folders, be it the section itself, a TV show, a movie, or even a season, Sub-Zero will skip processing the contents of that folder on a scheduled run.
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:
