This is a command line script that automatically searches for video subtitles using OpenSubtitles.org 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
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 setup.py 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 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
-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:
language: 3 letter code with the language to search subtitles for. Use the same code as it
appears when you change search languages (as in http://www.opensubtitles.org/en/search/sublanguageid-pob).
recursive: if directories should be recursively searched for movies.
skip: if movies that already have subtitles should be skipped. If this is 0 and a movie
already has subtitles,
ss won't overwrite the current subtitle, but generate a file using
the language as suffix; if that also already exists, it will use an additional "ss" prefix.
If you find any issues (not finding subtitles for a specific movie, errors, etc.), please report it in the issues page.