[OpenSubtitles] Exact VS Fuzzy Subtitle Search

How-to guides, frequently asked questions, not-so-obvious features, etc
Post Reply
User avatar
The Source
Posts: 20487
Joined: 16 Nov 2011, 08:59

[OpenSubtitles] Exact VS Fuzzy Subtitle Search

Post by rednoah »

The OpenSubtitles API supports 2 different ways to search for and lookup subtitles. On the OpenSubtitles website you will only be able to search for and upload subtitles by name which makes finding perfectly synced subtitles extremely troublesome. That's why OpenSubtitles native applications like FileBot use a special hash that is computed based on the actual video file so that perfectly matched subtitles can be downloaded fully automatically.

Exact Search: Lookup by Hash
When looking up subtitles via hash FileBot will only use a 8 byte hash computed from the video file as well as it's file size (e.g. hash=15597dfefd704c45, size=3636599158) to find perfectly matched subtitles. Since hash/size uniquely identifies a specific video file the subtitles a guranteed to be perfectly synced.

Only subtitles that have been uploaded with hash/size by OpenSubtitles native applications like FileBot can be retrieved via hash so when uploading subtitles, FileBot will require you to select the corresponding video file for each subtitle. In addition you will also need to select the Movie / Series so these subtitles so the subtitles can then be found by movie name or series name as well.

Fuzzy Search: Lookup by Name
If FileBot can't find subtitles via Exact Search it will default to searching for subtitles by name using information available in the video filename like movie name, series name, episode numbers, etc pretty much the same was as if you were looking up subtitles manually. FileBot will of course try to guess the best matching subtitles but perfectly matching subtitles cannot be guaranteed.

If you find subtitles for your video files via Fuzzy Search and have confirmed that the subtitles are perfectly synced to your video files, please using FileBot to upload the subtitles again so the missing hash/size information can be added to OpenSubtitles and make subtitle download all the more painless for all other users.
:idea: Please read the FAQ and How to Request Help.
Post Reply