0.03
Repository is archived
No commit activity in last 3 years
No release in over 3 years
An API to query popular torrent websites
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

The Torrent API

What it does

The Torrent API brings torrent downloading to the ruby language. It allows for searching numerous torrent websites using an easy-to-use ruby DSL.

How it does it

Using Nokogiri or Hpricot, it takes a search term (and sometimes a category) and grabs the page and parses through the HTML to scrape the results, leaving you with just the most important information.

Usage

Search the default service (the pirate bay)

t = TorrentApi.new
t.search_term = 'james and the giant peach'
results = t.search

Query all torrent websites and work with those torrents

torrents = TorrentApi.new(:all, 'the royal tenenbaums')
torrent = torrents.first
torrent.name
=> "The.Royal.Tenenbaums.XviD.DVD-Rip"
torrent.seeds
=> 128
torrent.size # size is returned in bytes
=> 702840000.0

Torrent methods

:name, :seeds, :leeches, :category, :link, :magnet_link, :status, :size

Select a service to use and search

t = TorrentApi.new
t.service = :demonoid
t.search_term = 'james and the giant peach'
results = t.search

Shorthand query all

TorrentApi.new(:all, "james and the giant peach")`

Available services

  • TorrentReactor
  • The Piratey Bay
  • Demonoid

How to help

Add more torrent sites!

To do

  • Refactor all three search engines to use a shared torrent model
  • More search engines!
  • Need to add/remove dependencies - awesome_print and nokogiri
  • Improve the ability to select a category (I think it defaults to a movie category right now)