This project is maintained by nicoddemus

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.

: 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.

: 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

Install using pip:

pip install ss

Requirements

Python 2.6+, 3.3+, PyPy.

guessit.

mkvmerge (optional).

Usage

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

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 .

Support

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

Changelog

See the releases page.