Opensubtitles

Client library for the Opensubtitles protocol. Currently the implentation is limited to movie identification and subtitles search.

Examples

Just read the source of bin/getsub it is a typical example of Opensubtitles's capacities.

getsub

The opensubtitles gem provide a simple script to find and download the best subtitle on opensubtitles.org for your video file.

Installation

$ gem install opensubtitles

Usage

getsub [options] DIRECTORY | VIDEO_FILE [VIDEO_FILE ...]

You just have to execute getsub with some video files in arguments:

$ getsub somemovie.avi othermovie.mkv

Or specify a directory to search recursively:

$ getsub ~/Movies

For options details just run:

$ getsub --help

Main options:

-a, --auto                       Do not ask user to resolve hash conflicts.

-l, --language LANGUAGE          Sub language ISO 639-2 code like fre or eng. Default: env $LANG (your-lang)

-f, --force                      Download sub even if video already has one

-t, --type FORMATS               Select only subtitles in specified formats. e.g -t srt,sub

-L, --language-extension         Add the ISO 639-2 in the subtitle's file extension. e.g filename.eng.srt

-s, --search-by METHODS          Ordered list of search methods. h: by movie hash, i: by name on IMDB, n: by name on Opensubtitles, p: by filename on Opensubtitles. e.g -s hi . Default: h