Sub-Zero - Subtitles done right

Current version: 1.3.33.522

Questions? Have a look at the wiki first

Introduction

Hey there,

Some of you may have followed the recent development on the original Subliminal.bundle by @bramwalet.

I've made some serious changes, improvements and bugfixes to Subliminal.bundle during the last few weeks, with the help of some very nice people such as @PMAdmin, @chopeta, @BlueToxic and others.

As the direction of this project has moved a long way, I thought it was time to evolve from simply being a personal fork of Subliminal.bundle to something more dedicated.

Plugin Description

Sub-Zero aims to solve your subtitle problems by automatically downloading the hopefully best subtitles there are, for your individual video file.

Subtitles are a problem? Yep, they definitely are. I myself use this plugin on a daily basis as my wife has a serious hearing condition where subtitles help us to be able to watch our favourite TV series and movies together. Subtitles pose a generic struggle: matching your media file perfectly. This is as hard as it gets. Thankfully there are a bunch of libraries and services out there, that help with that.

Sub-Zero is far from being perfect, but with recent development and planned features, we're really getting there.

Its core is based on the works of Diaoul, who created the subliminal library, as well as enzyme, to parse MKV metadata. In addition to that Sub-Zero uses the extremely well-made guessit library made by wackou.

Sub-Zero still is under heavy development but has recently reached a stable state. I need you to report bugs and tell me your opinion on new features.

It currently supports the following subtitle providers:

• Addic7ed (TV)
• opensubtitles (TV, movies)
• Podnapisi (TV, movies)
• TVsubtitles.net (TV)
• The SubDB (TV, movies)

Automatic Installation

• Sub-Zero now is listed in the official Plex Channel Directory. You can install it from there.

Downloads

Stable (when in doubt, use this one)

Current version: https://github.com/pannal/Sub-Zero.bundle/releases/latest
Legacy versions: https://github.com/pannal/Sub-Zero.bundle/releases

Develop

Release candidate: https://github.com/pannal/Sub-Zero.bundle/archive/master.zip
Bleeding edge (development): https://github.com/pannal/Sub-Zero.bundle/archive/develop.zip

Repository

https://github.com/pannal/Sub-Zero.bundle

Manual Installation

• go to Library/Application Support/Plex Media Server/Plug-ins/
• remove old versions (rm -r Sub-Zero.bundle)
• get the current version from here
• unpack it
• restart your plex media server!

Usage

• go to Settings -> Server -> Agents -> Movies/TV Shows
• select the metadata provider you use on your library, e.g.: Freebase (movies) or TheTVDB (series)
• enable Sub-Zero Subtitles (TV/Movies)
• configure them
• refresh your library (or individual movies/TV shows)

Use the following agent order:

1. Sub-Zero Subtitles (TV/Movies)
2. Local Media Assets (TV/Movies)
3. anything else

Documentation:

https://github.com/pannal/Sub-Zero/blob/master/README.md

Nice new shiny wiki

https://github.com/pannal/Sub-Zero.bundle/wiki

Beer is good on my free time (which is spent on Sub-Zero)

If you like this, why not buy me a beer:

Changelog

1.3.33.522

• core: fix library permission detection on windows; fixes #151
• core: "Restrict to one language" now behaves like it should (one found subtitle of any language is treated as sufficient); fixes #149
• core: add support for other subtitle formats such as ssa/ass/microdvd, convert to srt; fixes #138
• core: hopefully more consistent force-refresh handling (intent); fixes #118

1.3.31.513

• core: add option to only download one language again (and skip the addition of .lang to the subtitle filename) (default: off); fixes #126
• core: add option to always encode saved subtitles to UTF-8 (default: on); fixes #128
• core: add fallback encoding detection using bs4.UnicodeDammit; hopefully fixes #101
• core: update libraries: chardet, beautifulsoup, six
• menu/core: check Plex libraries for permission problems on plugin start and report them in the channel menu (option, default: on); fixes #143
• menu: while a manual refresh takes place, add a refresh button to the top of the SZ menu for convenience
• menu: move the "add/remove X to ignore list" menu item to the bottom of the list on item detail

older changes