.TH "btcompletedir.bittornado" "1" 
.SH "NAME" 
btcompletedir \(em creates torrent meta-info files for all files/directories within a directory 
.SH "SYNOPSIS" 
.PP 
\fBbtcompletedir\fR  \fItrackerURL\fR \fIdirectory\fR [\fIdirectory\fR \&...]  [\fB\-\-piece_size_pow2 \fInum\fR\fP]  [\fB\-\-comment \fIcomment\fR\fP]  [\fB\-\-filesystem_encoding \fIencoding\fR\fP]  [\fB\-\-httpseeds \fIseedURLlist\fR\fP]  [\fB\-\-announce_list \fIannounceURLlist\fR\fP]  
.SH "DESCRIPTION" 
.PP 
This manual page documents briefly the 
\fBbtcompletedir\fR command. 
.PP 
This manual page was written for the \fBDebian\fP distribution 
because the original program does not have a manual page. 
.PP 
\fBbtcompletedir\fR 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. 
.PP 
\fBbtcompletedir\fR requires two arguments. The first is the \fItrackerURL\fR which is the 
"announce" address of a tracker (ex. http://127.0.0.1:6969/announce), the second is the 
\fIdirectory\fR that you wish to parse to generate torrent info files. 
.PP 
\fBbtcompletedir\fR will parse each \fIdirectory\fR given and create a torrent file for every file and directory 
within it. All torrent files will also reside in the \fIdirectory\fR after the program is complete. 
.SH "OPTIONS" 
.PP 
These programs follow the usual GNU command line syntax, 
with long options starting with two dashes (`\-\-').  A summary of 
options is included below. 
.IP "\fB\-\-piece_size_pow2 \fInum\fR\fP" 10 
set the piece size to this power of 2 (0 = automatic) (defaults 
to 0) 
.IP "\fB\-\-comment \fIcomment\fR\fP" 10 
optional human-readable \fIcomment\fR to put in the torrent file (defaults to '') 
.IP "\fB\-\-filesystem_encoding \fIencoding\fR\fP" 10 
an optional \fIencoding\fR specification for the filesystem (set automatically in 
recent Python versions) (defaults to '') 
.IP "\fB\-\-httpseeds \fIseedURLlist\fR\fP" 10 
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 \fIseedURLlist\fR is as follows: 
.IP "" 10 
\fIURL\fR[|\fIURL\fR ...] 
.IP "" 10 
(defaults to '') 
.IP "\fB\-\-announce_list \fIannounceURLlist\fR\fP" 10 
a list of announce URLs. This is an optional list 
of redundant/backup tracker URLs. The format of \fIannounceURLlist\fR is as follows: 
.IP "" 10 
\fIURL\fR[,\fIURL\fR ...][|\fIURL\fR[,\fIURL\fR ...] ...] 
.IP "" 10 
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 \fItrackerURL\fR value. (defaults to '') 
.SH "EXAMPLES" 
.PP 
These examples show how to use the \-\-announce_list option in a few scenarios. 
.PP 
Try the three trackers (1-3) in sequential order: 
.PP 
.nf 
\fBbtcompletedir\fR \fItrackerURL\fR \fIdirectory\fR \-\-announce_list http://track1.com|http://track2.com|http://track3.com 
.fi 
.PP 
.PP 
Try the three trackers (1-3) in a randomly selected order: 
.PP 
.nf 
\fBbtcompletedir\fR \fItrackerURL\fR \fIdirectory\fR	\-\-announce_list http://track1.com,http://track2.com,http://track3.com 
.fi 
.PP 
.PP 
Try the main tracker (1) first, then try the two backups (2 and 3) randomly: 
.PP 
.nf 
\fBbtcompletedir\fR \fItrackerURL\fR \fIdirectory\fR	\-\-announce_list http://track1.com|http://track2.com,http://track3.com 
.fi 
.PP 
.SH "SEE ALSO" 
.PP 
\fBbtcompletedirgui\fP\fB(1)\fP, 
\fBbtmakemetafile\fP\fB(1)\fP, 
\fBbtmaketorrentgui\fP\fB(1)\fP, 
\fBbtshowmetainfo\fP\fB(1)\fP, 
\fBbittorrent-downloader\fP\fB(1)\fP. 
 
.SH "AUTHOR" 
.PP 
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 \fBDebian\fP 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. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man