0.0
No commit activity in last 3 years
No release in over 3 years
Ruby library to access subtitles services like OpenSubtitles.org
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0
~> 2.3.0
~> 1.8.11
 Project Readme

Opensubtitles

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

Build Status Gem Version

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

##Thanks

###Jean Boussier (byroot) from whom I forked this gem https://github.com/byroot/ruby-osdb ###Subtitles service powered by www.OpenSubtitles.org