btcompletedir creates torrent meta-info files for all files/directories within a directory
btcompletedir trackerURL directory [directory ...] [--piece_size_pow2 num] [--comment comment] [--filesystem_encoding encoding] [--httpseeds seedURLlist] [--announce_list announceURLlist]
This manual page documents briefly the
btcompletedir command.
This manual page was written for the Debian distribution
because the original program does not have a manual page.
btcompletedir is a program that is used to generate the torrent info files
that are distributed to bittorrent clients (usually over http) to inform them
of where the designated tracker for the torrent is located, and to enable them
to verify the file's contents.
btcompletedir requires two arguments. The first is the trackerURL which is the
"announce" address of a tracker (ex. http://127.0.0.1:6969/announce), the second is the
directory that you wish to parse to generate torrent info files.
btcompletedir will parse each directory given and create a torrent file for every file and directory
within it. All torrent files will also reside in the directory after the program is complete.
These programs follow the usual GNU command line syntax,
with long options starting with two dashes (`--'). A summary of
options is included below.
"--piece_size_pow2
set the piece size to this power of 2 (0 = automatic) (defaults
to 0)
"--comment
optional human-readable comment to put in the torrent file (defaults to '')
"--filesystem_encoding
an optional encoding specification for the filesystem (set automatically in
recent Python versions) (defaults to '')
"--httpseeds
a list of http seed URLs. These alternate URLs will be used to seed
the file if there are no other seeds available. The format of seedURLlist is as follows:
""
URL[|URL ...]
""
(defaults to '')
"--announce_list
a list of announce URLs. This is an optional list
of redundant/backup tracker URLs. The format of announceURLlist is as follows:
""
URL[,URL ...][|URL[,URL ...] ...]
""
where the URLs separated by commas are tried randomly, then the groups of URLs separated by pipes
are tried in sequential order.
If this option is omitted, it is assumed you don't want an announce_list field in the metafile.
If announce_list is given, clients which support it
will ignore the trackerURL value. (defaults to '')
These examples show how to use the --announce_list option in a few scenarios.
Try the three trackers (1-3) in sequential order:
btcompletedir trackerURL directory --announce_list http://track1.com|http://track2.com|http://track3.com
Try the three trackers (1-3) in a randomly selected order:
btcompletedir trackerURL directory --announce_list http://track1.com,http://track2.com,http://track3.com
Try the main tracker (1) first, then try the two backups (2 and 3) randomly:
btcompletedir trackerURL directory --announce_list http://track1.com|http://track2.com,http://track3.com
btcompletedirgui(1),
btmakemetafile(1),
btmaketorrentgui(1),
btshowmetainfo(1),
bittorrent-downloader(1).
This manual page was written by Cameron Dale <camrdale@gmail.com> (based on the original man pages written by Micah Anderson <micah@debian.org>) for
the Debian system (but may be used by others). Permission is
granted to copy, distribute and/or modify this document under
the terms of the GNU General Public License, Version 2 or any
later version published by the Free Software Foundation.
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.