arokettu/torrent-file-cli

CLI tool to manipulate torrent files

1.2.1 2025-05-26 22:46 UTC

Requires

• php: ^8.1
• composer-runtime-api: ^2.2
• arokettu/bencode: ^4.3.1
• arokettu/json: ^2.1
• arokettu/json5-builder: ^1.1 || ^2.0
• arokettu/kilo-mega: ^1.1
• arokettu/torrent-file: ^5.3
• colinodell/json5: ^3.0
• sabre/xml: ^4.0
• symfony/console: ^6.2 || ^7.0
• symfony/polyfill-intl-icu: ^1.28
• symfony/var-dumper: ^6.2 || ^7.0

Requires (Dev)

• ext-openssl: *
• sandfox.dev/code-standard: ^1.2025.05.07
• squizlabs/php_codesniffer: *
• vimeo/psalm: ^6

Suggests

• ext-openssl: for signature logic

MIT

• Anton Smirnov

• cli
• console
• bittorrent
• torrent

README

A CLI tool to manipulate torrent files.

Installation

Install for local user with composer:

composer global require arokettu/torrent-file-cli

Install globally by downloading prebuilt phar:

sudo wget https://github.com/arokettu/torrent-file-cli/releases/latest/download/torrent-file.phar -O /usr/local/bin/torrent-file
sudo chmod +x /usr/local/bin/torrent-file

Examples

Create file:

torrent-file create ~/build/myapptoupload -o ~/build/myapptoupload.torrent 

Modify torrent fields:

torrent-file modify ~/build/myapptoupload.torrent --announce http://tracker

Inspect torrent file:

torrent-file show ~/build/myapptoupload.torrent

Dump raw torrent file structure:

torrent-file dump ~/build/myapptoupload.torrent

Sign torrent file:

torrent-file sign torrent.torrent key.pem cert.pem

Documentation

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

Also on Read the Docs: https://torrent-file-cli.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

License

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