Created: 2011-07-11 12:06
Updated: 2013-01-03 20:33

Subtitle Source

Ruby bindings for

Follow me on Twitter or Github for more info and updates.

How to use

Request an API key

You can easily request an API key at the Subtitle Source API page.


Pass your API key to the constructor.
This is just an example.

@subtitles ="6894b779456d330e")

Search for a subtitle


Specify a language


Find by IMDb id"tt0813715").fetch

Specify a page

Default is 1.
20 results per page."tt0813715").page(2).fetch

Find subtitle based on a release name"tt0813715").fetch.based_on("The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS").title
# => "The Town"


Specify how sensitive the based_on method should be, 0.0 to 1.0. Default is 0.4."tt0813715").fetch.based_on("The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS", limit: 0.0).release_name
# => "The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS"

Data to work with

The fetch method returns a list for subtitles. Each subtitle has the following accessors."tt0813715").fetch.first.release_name
# => "Heroes.S03E09.HDTV.XviD-LOL"
  • title (String) Movie/TV serie title.
  • imdb (String) IMDb id.
  • id (Fixnum) Subtitle Source id.
  • rid (Fixnum) Same as above, I think.
  • language (String) Subtitle language.
  • season (Fixnum) Season for the given TV serie.
  • episode (Fixnum) Episode for the given TV serie.
  • release_name (String) Subtitle release name.
  • fps (Fixnum) Frames per second.
  • cd (Fixnum) The amount of cd's for the given TV serie.
  • details (String) Url to the details page. Example.
  • url (String) Url to the zipped subtitle. Example.
  • hi (Fixnum)

How to install

[sudo] gem install subtitlesource


Subtitle Source is tested in OS X 10.6.8 using Ruby 1.9.2.


Subtitle Source is released under the MIT license.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more