ss 1.6.0

Command line script that automatically searches for video subtitles using OpenSubtitles.org APIs.

# Subtitle Searcher - SS #

Command line script for searching video subtitles using [OpenSubtitles.org](http://www.opensubtitles.org ) APIs.


[](https://pypi.python.org/pypi/ss/) [](https://pypi.python.org/pypi/ss/) [](https://pypi.python.org/pypi/ss/) [](https://travis-ci.org/nicoddemus/ss) [](https://coveralls.io/r/nicoddemus/ss)

## 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](http://www.bunkus.org/videotools/mkvtoolnix).

## Install ##

Install using [pip](http://www.pip-installer.org):

`bash pip install ss `

## Requirements ##

• Python 2.6+, 3.3+, PyPy.

• [guessit](https://github.com/wackou/guessit).

• [mkvmerge](http://www.bunkus.org/videotools/mkvtoolnix) (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:

`ini [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](http://www.matroska.org/) file with embedded video and subtitles. Utility [mkvmerge](http://www.bunkus.org/videotools/mkvtoolnix) 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](https://github.com/nicoddemus/ss/issues).

## Changelog ##

See the [releases page](https://github.com/nicoddemus/ss/releases).