skip to navigation
skip to content

ss 1.5.2

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

# Subtitle Searcher - SS #

Command line script for searching video subtitles using []( ) APIs.


[![py_versions](]( [![version](]( [![downloads](]( [![ci](]( [![coverage](](

## 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 ##

Install using [pip](

`bash pip install ss `

## Requirements ##

## 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
  • 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](

File Type Py Version Uploaded on Size
ss-1.5.2-py2.py3-none-any.whl (md5) Python Wheel 2.7 2014-11-03 12KB (md5) Source 2014-11-03 21KB
  • Downloads (All Versions):
  • 60 downloads in the last day
  • 311 downloads in the last week
  • 1404 downloads in the last month