arokettu/torrent-file

A class to work with torrent files

5.3.2 2025-06-28 21:41 UTC

Requires

• php: ^8.1
• ext-hash: *
• arokettu/bencode: ^2.8 | ^3.1 | ^4.0
• nikic/iter: ^2.2
• psr/event-dispatcher: ^1.0
• symfony/filesystem: ^5.4 | ^6.0 | ^7.0
• symfony/finder: ^5.4 | ^6.0 | ^7.0

Requires (Dev)

• ext-openssl: *
• jetbrains/phpstorm-attributes: ^1.0
• league/event: ^3.0
• phpunit/phpunit: ^10.5.3
• psy/psysh: *
• sandfox.dev/code-standard: ^1.2025.05.07
• squizlabs/php_codesniffer: *
• vimeo/psalm: ^5.2 | ^6

Suggests

• ext-openssl: for signature logic

MIT

• Anton Smirnov

• bittorrent
• torrent
• torrent-file

README

A PHP Class to work with torrent files

Installation

composer require arokettu/torrent-file

Usage

<?php

use Arokettu\Torrent\TorrentFile;

// open file
$torrent = TorrentFile::load('debian.torrent');
// create for path (file or directory)
$torrent = TorrentFile::fromPath('/home/user/dists/debian');

// manipulate fields
$torrent->setAnnounce('http://tracker.example:1234');

// list files
foreach ($torrent->v1()->getFiles() as $file) {
    echo implode('/', $file->path()) , ': ' , $file->length, PHP_EOL;
}

Features

• Torrent file data manipulation
• Torrent file creation
• Torrent file listing
• Support for torrent files version 1, version 2, Hybrid v1+v2, a lot of BEPs like Nodes, Url Lists, etc
• Torrent file signing

CLI tool

A CLI tool based on the library: https://sandfox.dev/php/torrent-file-cli.html

Documentation

Read full documentation here: https://sandfox.dev/php/torrent-file.html

Also on Read the Docs: https://torrent-file.readthedocs.io/

Support

Please file issues on our main repo at GitLab: https://gitlab.com/sandfox/torrent-file/-/issues

Feel free to ask any questions in our room on Gitter: https://gitter.im/arokettu/community

Supported versions:

• 5.x (current, PHP 8.1+)

License

The library is available as open source under the terms of the MIT License.