Scroll to navigation

BUILDTORRENT(1) User Commands BUILDTORRENT(1)

NAME

buildtorrent - a torrent file creation program.

SYNOPSIS

buildtorrent [OPTIONS] input output

buildtorrent [OPTIONS] -f filelist -n name output

DESCRIPTION

buildtorrent is a torrent file creation program. Given appropriate options and an input file or directory, buildtorrent generates an output .torrent file that can be used by torrent clients.

OPTIONS

Announce URL. Can be omitted for trackerless torrents (BEP-5).
A text file (or - for standard input) containing a list of files to add to the output torrent file, together with the path to use inside the torrent. One file is given per line, use / as path separator for the torrent path, use | to separate the filesystem path from the torrent path. Backslash \ can be used to escape newlines and | characters inside names. For example:

/data/files/linux.iso|bin/linux.iso
/data/files/linux.txt|doc/linux.txt

Using this option requires that the --name option be used.
Specify the name for the torrent. Usage of this option is required when the --filelist option is used, in which case it specifies the name of the torrent directory. Usage without a file list overrides the name of the directory or file given on the command line.
Additional announce URL list (BEP-12). Use , to separate outer level lists, and | to separate inner level items; for example:

a,b1|b2,c
DHT nodes list (for trackerless torrents) (BEP-5). Use , to separate items, and | to separate host from port; for example:

>RS 127.0.0.1|6881,example.com|1337

Additional WebSeed URL list (BEP-19). Use , to separate items; for example:

a,b,c
Piece length in bytes (default 262144).
Use 2^size as piece length (default 18) (overrides -l ).
User comment (omitted by default).
Private flag (either 0 or 1) (BEP-27).
Override creation date field with a UNIX timestamp (number of seconds since 1970 epoch).
Omit the creation date field entirely.
Override created by field.
Omit the created by field entirely.
Add an md5sum field for each file.
Filename sorting method (only when in filesystem directory mode): any one of Unsorted, Alpha, Version (when available).
Show a magnet link for the generated torrent file.
Quiet operation with reduced output.
Verbose operation with increased output (may be used multiple times for more verbosity).
Show the version string.
Show a help screen with brief usage information.

NOTES

The previous -s and -S options have been removed; use -v and -vv instead. The previous -C option has been removed; use -B instead.

AUTHORS

Claude Heiland-Allen (claude@mathr.co.uk)

SEE ALSO

createtorrent(1), mktorrent(1)

http://wiki.theory.org/BitTorrentSpecification
http://bittorrent.org/beps/bep_0005.html
http://bittorrent.org/beps/bep_0012.html
http://bittorrent.org/beps/bep_0019.html
http://bittorrent.org/beps/bep_0027.html
August 2024 0.9.1