{"id":21201663,"url":"https://github.com/oleander/btjunkie","last_synced_at":"2025-12-29T18:10:08.580Z","repository":{"id":1442737,"uuid":"1673086","full_name":"oleander/Btjunkie","owner":"oleander","description":"The unofficial API for btjunkie.org","archived":false,"fork":false,"pushed_at":"2011-05-23T22:54:24.000Z","size":156,"stargazers_count":1,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-21T11:49:54.192Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://github.com/oleander/Btjunkie","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-04-27T22:26:25.000Z","updated_at":"2016-09-25T02:51:48.000Z","dependencies_parsed_at":"2022-07-29T13:39:11.347Z","dependency_job_id":null,"html_url":"https://github.com/oleander/Btjunkie","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2FBtjunkie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2FBtjunkie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2FBtjunkie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oleander%2FBtjunkie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oleander","download_url":"https://codeload.github.com/oleander/Btjunkie/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.842Z","updated_at":"2025-12-29T18:10:08.481Z","avatar_url":"https://github.com/oleander.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Btjunkie\n\nUnofficial API for [Btjunkie](http://btjunkie.org/).\n\n## How to use\n\nFetch torrents from the [video section](http://btjunkie.org/browse/Video?o=72\u0026t=0).\n\n### Most recent\n\n```` ruby\nBtjunkie.category(:movies)\n````\n\n### Specify a page\n\n```` ruby\nBtjunkie.page(12).category(:movies)\n````\n\nDefault is `1`.\n\n### Cookies\n\nBtjunkie requires that you pass some cookies to fetch there data.\nYou can easily do that by specifying the `sessid`.\n\n```` ruby\nBtjunkie.cookies({\n  sessid: \"1212lksdjfkj3lkeda090w83922af6b\"\n})\n````\n### Get info about a url\n\nYou can easily get detailed info about a torrent using the `find_by_details` method.\n\n```` ruby\nurl = \"http://btjunkie.org/torrent/Pirates-of-the-Caribbean-4-2011-XViD-MEM-ENG-AUDIO/3952ef0859f08bbc7b63c97c51bd9a02e154e0c38026\"\ntorrent = Btjunkie.find_by_details(url)\ntorrent.title # =\u003e Pirates of the Caribbean 4 2011 XViD- MEM [ENG AUDIO]\n````\nThe `find_by_details` method returns a `Torrent` object.\n\n## Data to work with\n\nAs soon as the `results` method is applied to the query a request to *Btjunkie* is made.\nThe `results` method returns a list of `Torrent` object with the following methods.\n\n- **title**      (*String*) The title.\n- **details**    (*String*) The url to the details page.\n- **torrent**    (*String*) The url. This should be a direct link to the torrent.\n- **tid**        (*String*) The `tid` method, also known as `torrent id` is a *truly* unique identifier for all torrents. It is generated using a [MD5](http://sv.wikipedia.org/wiki/MD5) with the torrent domain and the `id` method as a seed.\n- **torrent_id** (*String*) The same as the `tid` method.\n- **dead?**      (*Boolean*) Check to see if the torrent has no seeders. If it has no seeders, then `dead?` will be true.\n- **id**         (*Fixnum*) An unique id for the torrent. The id is only unique for this specific torrent, not all torrents.\n- **seeders**    (*Fixnum*) The amount of seeders.\n- **subtitle**   (*[Undertexter](https://github.com/oleander/Undertexter)*) The subtitle for the torrent. Takes one argument, the language for the subtitle. Default is `:english`. Read more about it [here](https://github.com/oleander/Undertexter).\n- **movie**      (*[MovieSearcher](https://github.com/oleander/MovieSearcher)*) Read more about the returned object at the [MovieSearcher](https://github.com/oleander/MovieSearcher) project page.\n- **valid?**     (*Boolean*) Is the torrent valid? Does it contain the correct value for #id, #torrent and #details?\n\n```` ruby\ntorrents = Btjunkie.category(:movies).results\nputs torrents.class       # =\u003e Array\nputs torrents.first.class # =\u003e BtjunkieContainer::Torrent\n````\n\n## How do install\n\n    [sudo] gem install btjunkie\n\n## Requirements\n\n*Btjunkie* is tested in *OS X 10.6.7* using Ruby *1.8.7*, *1.9.2*.\n\n## License\n\n*Btjunkie* is released under the *MIT license*.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fbtjunkie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foleander%2Fbtjunkie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foleander%2Fbtjunkie/lists"}