SS

Automatically finds subtitles for multiple movies using OpenSubtitle.org APIs

View the Project on GitHub nicoddemus/ss

Subtitle Searcher - SS

Introduction

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

OpenSubtitles.org

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

version downloads ci

Requirements

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

Install

Install using pip:

pip install ss

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

python setup.py install

Usage

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 ss.py Parks.and.Recreation.S05E13.HDTV.x264-LOL.mp4 The.Mentalist.S05E14.HDTV.x264-LOL.mp4
    Language: eng
    Querying OpenSubtitles.org for 2 file(s)...

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

    Downloading...
     - Parks.and.Recreation.S05E13.HDTV.x264-LOL.srt                      DONE
     - The.Mentalist.S05E14.HDTV.x264-LOL.srt                             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 ss.py --config language=pob recursive=1
    language=pob
    recursive=1
    skip=1

The following options are available:

Support

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