Media Score - pannal/Sub-Zero.bundle GitHub Wiki
Information
Sub-Zero detects certain media properties of your media files (especially their file names) and compares them to the same properties derived from a potential subtitle.
Every significant property has a particular score assigned. When evaluating which subtitle to download Sub-Zero sums the scores for each matching property and takes the one with the highest.
The minimum score a subtitle has to have for it to be downloaded by Sub-Zero can be set in the preferences dialog. The defaults should fit perfectly for most people, you may wish to customize them to your likings, though. Have a look below, then.
Properties (TV Series)
hash (Score: 359)
The specific hash of your local file matches against the hash given by the subtitle provider for the file(s) it matches perfectly for. This is error-prone as people tend to add wrong hashes for wrong subtitles on OpenSubtitles especially. That's why Sub-Zero sanity-checks the hashes and only applies the score if certain other parameters match correctly (series, season, episode, format).
series (Score: 180)
The series title matches.
year (Score: 90)
The year info of the series matches (either none given or correct one given)
season (Score: 30)
The season number matches yours.
episode (Score: 30)
The episode number matches yours.
release_group (Score: 15)
The release group for that particular subtitle matches the release group of your media file.
format (Score: 7)
The format matches (HDTV, BluRay, WEB-DL, WEBRip, DVDRip, ...).
video_codec (Score: 2)
The video codec matches (x264, XViD, ...).
resolution (Score: 2)
The resolution matches (720p, 1080p, ...). Probably one of the parameters that can be ignored the most. Hence the low score.
audio_codec (Score: 3)
The audio codec matches (AAC, MP3, ...). Probably one of the parameters that can be ignored the most. Hence the low score.
hearing_impaired (Score: 1)
The hearing impaired flag matches your Sub-Zero setting. (E.g. you've got the setting at force-HI and the subtitle is hearing impaired: match)
Properties (Movies)
hash (Score: 119)
See TV hash property. The only difference is the sanity check, which relies on matching video_codec and format.
title (Score: 60)
The movie title matches.
year (Score: 30)
A year info is given and it matches the subtitle.
release_group (Score: 15 (v2: 15))
See TV release_group property.
format (Score: 7)
See TV format property.
video_codec (Score: 2)
resolution (Score: 2)
audio_codec (Score: 3)
hearing_impaired (Score: 1)
See TV hearing_impaired property.
Defaults
- Minimum: Find subtitles no matter what
- Sane: Find subtitles matching your media file
- Ideal: Find subtitles mostly exactly matching your media file (same video format or same release group)
- Exact: Find subtitles exactly matching your media file
TV
Minimum: 240 and above
series 180 + season 30 + episode 30 = 240
Sane: 337 and above (default)
series 180 + season 30 + episode 30 + year 90 + format 7 = 337
Ideal: 352 and above
series 180 + season 30 + episode 30 + year 90 + release_group 15 + format 7 = 352
Exact: 359 (few to none early matches)
verified hash = 359 or
resolution 2 + format 7 + video_codec 2 + audio_codec 3 + series 180 + season 30 + episode 30 + year 90 + release_group 15 = 359
Movies
Minimum: 60 and above (default)
title 60 = 60
Sane: 69 and above
title 60 + format 7 + video_codec 2 = 69
Ideal: 82 and above
title 60 + format 7 + release_group 15 = 82
Exact: 119 (few to none early matches)
verified hash 119 = 119 or
resolution 2 + format 7 + video_codec 2 + audio_codec 3 + title 60 + year 30 + release_group 15 = 119
Special scores
addic7ed_boost (TV)
Can be configured in the preferences dialog. If a subtitle was found for your configured score on Addic7ed and it matches at least series, season, episode, year, format, the configured value gets added to the subtitle's final score to lift it "above" the other provider's results.
This is often used and has a default value of 10, because in general, when Addic7ed matches a subtitle, it tends to have a very high quality compared to other providers. As Addic7ed doesn't use hashes and doesn't have too much media property info on their site, addic7ed_boost helps by prioritizing the provider.