User Guide
#TODO: Replace pics, and make text match
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. If 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
- Here you see the medias that are On Deck (returned by the Plex API), allowing you to manipulate the subtitles
- Recently-added Items
- Same as above, but for Recently Added Items
- Items with missing subtitles
- Here you search for items considered recent (See the Sub‐Zero Configuration menu)
- you can then select the individual medias, and select between the medias as on above
- Here you search for items considered recent (See the Sub‐Zero Configuration menu)
- Browse all items
- here you start by selecting a library, and then a media based on the alphabet list.
- after that, menu is as this]
- here you start by selecting a library, and then a media based on the alphabet 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
- List all items in the Ignore list, and allowing you to remove an item, if needed
- Display History of latest downloaded subtitles
- Refresh
- This will 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 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.
BETA notes: This may still mean that the scheduler task for missing subtitles triggers refresh actions on those items, but the refresh handler itself will skip those.
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:
