torrent – bittorrent client
BitTorrent is a protocol for efficient file distribution
over the internet. Files are split into small pieces
that are then downloaded by clients in random order.
As soon as a client completes a piece, it makes the piece
available for others to download.
To find other clients (peers), a tracker-server is
Before files can be transmitted, a torrent-file needs
to be created describing the pieces of the files and
other meta-data like network addresses of the trackers.
This is done with the
option. If provided,
reads the file given at the final
argument (or standard-input when omitted) and writes
a torrent file to standard-output and exits.
should be given with the
option in that case. A list of trackers can be obtained
on the web, see the examples below.
If the files in the torrent are also available from a url, a
can be passed with the
ends with a slash, the filename, from the torrent, concatenated
with the url forms the target url.
downloads the files that are described in the torrent-file
given by the
argument to the current working directory. If no
is given, the torrent is read from standard-input.
Normally, the program exits immediately after all pieces
have been completed.
option causes it to keep running and serve the remaining
clients (also known as seeding).
Trackers use a subset of the HTTP protocol, so an
mountpoint can be given with the
option (defaults to
to list the files in the torrent-file before downloading.
option produces verbose debug output to standard-error.
To monitor the download progress, the
option can be given to cause the completed and total number of
pieces written as a line of text to standard-output in one
option allows you to set the 20-byte
that is sent to trackers and peers. If less than 20 bytes, the
will be padded on the right with random ASCII numbers. The
option allows setting the http
string that is used to contact the tracker. These options are
useful to fool trackers that filter clients based on the
Create new torrent file
ip/torrent -t http://exodus.desync.com/announce \\
-c 9atom.iso >9atom.torrent
Download the latest iso file of the distribution
hget http://r-36.net/9front/9front.iso.bz2.torrent | \\
ip/torrent -pv | \\
Get list of public alive trackers to choose from
first appeared in 9front (October, 2011).