btcompletedir — creates torrent meta-info files for all files/directories
within a directory
btcompletedir trackerURL directory
[--piece_size_pow2 num] [--comment
comment] [--filesystem_encoding encoding]
[ --httpseeds seedURLlist] [--announce_list
This manual page documents briefly the btcompletedir
This manual page was written for the Debian
distribution because the
original program does not have a manual page.
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.
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
wish to parse to generate torrent info files.
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 num
- set the piece size to this power of 2 (0 = automatic)
(defaults to 0)
- --comment comment
- optional human-readable comment to put in the
torrent file (defaults to '')
- --filesystem_encoding encoding
- an optional encoding specification for the
filesystem (set automatically in recent Python versions) (defaults to
- --httpseeds seedURLlist
- 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 announceURLlist
- a list of announce URLs. This is an optional list of
redundant/backup tracker URLs. The format of announceURLlist is as
- 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
This manual page was written by Cameron Dale <firstname.lastname@example.org> (based
on the original man pages written by Micah Anderson <email@example.com>)
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.