apollorip/bencode-torrent

PHP Library for decoding and encoding BitTorrent BEncoded data, built for Gazelle

BEncode Torrent

, _(*1)

PHP library for encoding and decoding BitTorrent BEncode data, focused around usage within Gazelle., _(*2)

Usage

composer require orpheusnet/bencode-torrent, _(*3)

require('vendor/autoload.php');
$bencode = new \OrpheusNET\BencodeTorrent\BencodeTorrent();
$bencode->decodeFile('path/to/file.torrent');
var_dump($bencode->getName());
var_dump($bencode->getHexInfoHash());
var_dump($bencode->getFileList());

See the BencodeTorrent class for more information on the available methods. Additionally, see Bencode for the underlying library to encode/decode BEncode data., _(*4)

Description

BEncode is the encoding used by BitTorrent to store and transmitting loosely structured data. It supports:, _(*5)

• byte strings
• integers
• lists
• dictionaries (associative arrays, where keys are sorted alphabetically)

You can see more information about how these types are supported at BitTorrentSpecification#Bencoding., _(*6)

In addition to the above, torrent files are expected to be BEncoded dictionaries that contain minimally the keys announce__ (byte string) and __info__ (dictionary). Within the __info dictionary, we then expect piece length (integer) and __pieces__ (byte string). If the torrent has only a single file, we then expect __name__ (byte string) and __length__ (integer), whereas for a multi-file torrent, we'll have __name__ (byte string) and __files__ (list) where each element is a dictionary that has the keys __length__ (integer) and __path__ (list of strings)., _(*7)

As such, this library will make some checks when loading data that these mandatory fields exist or else an Exception is raised. More information on these fields can be found at BitTorrentSpecification#Metainfo_File_Structure., _(*8)

Finally, this library is primarily aimed at being used within the Gazelle so we have some utility functions within the library that make sense there to accomplish the following things:, _(*9)

• Ensuring torrent files are marked as 'private'
• Setting a 'source' on torrents (to ensure unique info hash)
• Cleaning out unnecessary fields that also reveal stuff about a user (like announce list and created by)
• Generate string file lists as expected by Gazelle for display

This is based (loosely) off the code in the two separate BEncode libraries within WCD's Gazelle (bencodetorrent.class.php and torrent.class.php), but without the now unnecessary 32bit shims as well as making it a unified library used for both uploading and downloading the torrent files., _(*10)