Subtitle Searcher - SS

Command line script for searching video subtitles using OpenSubtitles.org APIs.

Features

Recursive search: Search subtitles for all videos inside a directory (and sub-directories), making it easy to download subtitles for TV shows packs.
Multiple languages: Search for more than one subtitle languages at the same time.
MKV embedding: Can automatically create an MKV file with embedded subtitles, which is easier to carry around. Requires mkvmerge.

Install using pip:

pip install ss

Pass the name of one or more video files or directories:

It will try to find the best match online, and automatically download and move the subtitles to the same folder as the video files.

Configuration is stored in ~/.ss.ini (or C:\Users\<user>\.ss.ini on Windows) as a standard ini file:

[ss]
languages=eng, pob
recursive=yes
skip=yes
mkv=no

The following options are available:

languages: 3 letter codes with the languages to search subtitles for, separated by commas. For a full list of available languages, see http://www.opensubtitles.org/addons/export_languages.php.
recursive: if directories should be recursively searched for movies (yes|no).
skip: if movies that already have subtitles should be skipped (yes|no).
mkv: if yes, it will automatically create a mkv file with embedded video and subtitles. Utility mkvmerge must be available in the $PATH environment variable (yes|no).
parallel_jobs: number of concurrent threads used to download subtitles and create mkv files. Defaults to 8.

If you find any issues, please report it in the issues page.