0.0
No commit activity in last 3 years
No release in over 3 years
An implementation of the UDP/TCP torrent scrape protocol
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0
>= 0

Runtime

 Project Readme

Firecracker

An implementation of the UDP/TCP torrent scrape protocol.

Get started

All methods below returns a hash similar to this one.

{
  seeders: 123,
  leechers: 456,
  downloads: 789
}

Specify a protocol

A second argument may be passed to load, raw and calculate to specify which protocol to use. An example argument would look like this: [:tcp, :udp], both tcp and udp are defaults.

A local torrent file

Firecracker.load("path/to/file.torrent")

A raw torrent string

torrent = RestClient.get("http://mysite.com/file.torrent")
Firecracker.raw(torrent)

A String#bdecode hash

torrent = RestClient.get("http://mysite.com/file.torrent")
Firecracker.calculate(torrent.bdecode)

Helper methods

Ingoing argument (torrent) is from now on a String#bdecode hash.

require "bencode_ext"
torrent = File.read("path/to/file.torrent").bdecode

Generate a info_hash string

Firecracker.hash(torrent)
# => "03db8637a8e16f7d5e3e4f7557d5d87b1905dc16"

A list of TCP/UDP trackers

Firecracker.udp_trackers(torrent)
# => ["udp://tracker.openbittorrent.com:80", "..."]

Firecracker.tcp_trackers(torrent)
# => ["http://torrent.ubuntu.com:6969/scrape", "..."]

UDP/TCP requests

If you want to define your own server or/and protocol you can do this using the TCPScraper and UDPScraper classes.

The hash being passed is a info_hash string.

You can in theory pass up to 72 hashes in one request.

Keep in mind that if one of the passed hashes is invalid or doesn't exist, the requested server might return 404 or 400.
It's therefore recommended to make one request for each hash.

TCP

Firecracker::TCPScraper.new({
  tracker: "exodus.desync.com:6969/announce",
  hashes: ["c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0"]
}).process!

# => {
#   c2cff4acc8f5b49fd6b93b88fc0423467fbb08b0: {
#     seeders: 123,
#     leechers: 456,
#     downloads: 789
#   }
# }

UDP

Firecracker::UDPScraper.new({
  tracker: "tracker.openbittorrent.com",
  hashes: ["523d83e8aee1a979e66584b5304d2e8fdc9a1675"]
}).process!

# => {
#   523d83e8aee1a979e66584b5304d2e8fdc9a1675: {
#     seeders: 123,
#     leechers: 456,
#     downloads: 789
#   }
# }

How to install

[sudo] gem install firecracker

Requirements

Ruby 1.9.2.

License

Firecracker is released under the MIT license.