{"id":21201660,"url":"https://github.com/oleander/subtitle_source","last_synced_at":"2025-03-14T22:25:59.985Z","repository":{"id":56896810,"uuid":"2030020","full_name":"oleander/subtitle_source","owner":"oleander","description":"Ruby bindings for subtitlesource.org","archived":false,"fork":false,"pushed_at":"2011-07-12T16:28:28.000Z","size":129,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-21T18:02:59.011Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/oleander/subtitle_source","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oleander.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2011-07-11T12:06:52.000Z","updated_at":"2013-01-03T20:33:01.000Z","dependencies_parsed_at":"2022-08-21T01:20:39.548Z","dependency_job_id":null,"html_url":"https://github.com/oleander/subtitle_source","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fsubtitle_source","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fsubtitle_source/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fsubtitle_source/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2Fsubtitle_source/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oleander","download_url":"https://codeload.github.com/oleander/subtitle_source/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243654400,"owners_count":20325893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T20:10:23.543Z","updated_at":"2025-03-14T22:25:59.954Z","avatar_url":"https://github.com/oleander.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Subtitle Source\n\nRuby bindings for [subtitlesource.org](http://www.subtitlesource.org/).\n\nFollow me on [Twitter](http://twitter.com/linusoleander) or [Github](https://github.com/oleander/) for more info and updates.\n\n## How to use\n\n### Request an API key\n\nYou can easily request an API key at the [Subtitle Source API page](http://www.subtitlesource.org/help/contact).\n\n### Initialize \n\nPass your API key to the constructor.  \n*This is just an example.*\n\n```` ruby\n@subtitles = SubtitleSource.new(\"6894b779456d330e\")\n````\n\n### Search for a subtitle\n\n```` ruby\n@subtitles.query(\"Heroes.S03E09.HDTV.XviD-LOL\").fetch\n````\n\n### Specify a language\n\n```` ruby\n@subtitles.language(\"english\").query(\"Heroes.S03E09.HDTV.XviD-LOL\").fetch\n````\n\n### Find by IMDb id\n\n```` ruby\n@subtitles.imdb(\"tt0813715\").fetch\n````\n\n### Specify a page\n\nDefault is *1*.  \n*20* results per page.\n\n```` ruby\n@subtitles.imdb(\"tt0813715\").page(2).fetch\n````\n\n### Find subtitle based on a release name\n\n```` ruby\n@subtitles.imdb(\"tt0813715\").fetch.based_on(\"The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS\").title\n# =\u003e \"The Town\"\n````\n\n### Sensitive\n\nSpecify how sensitive the `based_on` method should be, `0.0` to `1.0`. Default is `0.4`.\n\n```` ruby\n@subtitles.imdb(\"tt0813715\").fetch.based_on(\"The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS\", limit: 0.0).release_name\n# =\u003e \"The Town EXTENDED 2010 480p BRRip XviD AC3 FLAWL3SS\"\n````\n\n## Data to work with\n\nThe `fetch` method returns a list for subtitles. Each subtitle has the following accessors.\n\n```` ruby\n@subtitles.imdb(\"tt0813715\").fetch.first.release_name\n# =\u003e \"Heroes.S03E09.HDTV.XviD-LOL\"\n````\n\n- **title** (*String*) Movie/TV serie title.\n- **imdb** (*String*) IMDb id.\n- **id** (*Fixnum*) Subtitle Source id.\n- **rid** (*Fixnum*) Same as above, I think.\n- **language** (*String*) Subtitle language.\n- **season** (*Fixnum*) Season for the given TV serie.\n- **episode** (*Fixnum*) Episode for the given TV serie.\n- **release_name** (*String*) Subtitle release name.\n- **fps** (*Fixnum*) Frames per second.\n- **cd** (*Fixnum*) The amount of cd's for the given TV serie.\n- **details** (*String*) Url to the details page. [Example](http://www.subtitlesource.org/subs/73538/Source.Code.(2011).DVDRip.XviD-MAXSPEED).\n- **url** (*String*) Url to the zipped subtitle. [Example](http://www.subtitlesource.org/download/zip/73538).\n- **hi** (*Fixnum*)\n\n## How to install\n\n    [sudo] gem install subtitlesource\n\n## Requirements\n\n*Subtitle Source* is tested in *OS X 10.6.8* using Ruby *1.9.2*.\n\n## License\n\n*Subtitle Source* is released under the *MIT license*.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fsubtitle_source","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foleander%2Fsubtitle_source","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fsubtitle_source/lists"}