Automatically finds subtitles for multiple movies using APIs

View the Project on GitHub nicoddemus/ss

Subtitle Searcher - SS


This is a command line script that automatically searches for video subtitles using APIs.

One advantage is that it can automatically search for all videos inside a directory, making it easy to download subtitles for TV shows packs. Also, it can usually be configured by any download manager to automatically execute it when a movie or video finishes.

Latest Release: 1.4.2

version downloads ci


Python 2.6, 2.7, 3.3, 3.4 or PyPy. Also uses the guessit package.


Install using pip:

pip install ss

Or if you download the source, execute on the extracted folder:

python install


Just pass the name of the video file or a directory, in which case it will search for all video files in that directory:

    ] python Parks.and.Recreation.S05E13.HDTV.x264-LOL.mp4 The.Mentalist.S05E14.HDTV.x264-LOL.mp4
    Language: eng
    Querying for 2 file(s)...

    - Parks.and.Recreation.S05E13.HDTV.x264-LOL.mp4                       OK
    - The.Mentalist.S05E14.HDTV.x264-LOL.mp4                              OK

     -                      DONE
     -                             DONE

It will try to find the best match online, and automatically download and rename the subtitles.

To change language and other options, use --config (or -c). For instance, to change the language to Brazillian Portuguese and enable searching for files recursively, use:

    ] python --config language=pob recursive=1

The following options are available:


If you find any issues (not finding subtitles for a specific movie, errors, etc.), please report it in the issues page.