NAME

       btcompletedir — creates torrent meta-info files for all files/directories within a directory

SYNOPSIS

       btcompletedir   trackerURL  directory  [directory  ...]   [--piece_size_pow2  num]   [--comment  comment]
       [--filesystem_encoding encoding]  [--httpseeds seedURLlist]  [--announce_list announceURLlist]

DESCRIPTION

       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.

OPTIONS

       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 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 '')

EXAMPLES

       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

SEE ALSO

       btcompletedirgui(1), btmakemetafile(1), btmaketorrentgui(1), btshowmetainfo(1), bittorrent-downloader(1).

AUTHOR

       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.

                                                                                     btcompletedir.bittornado(1)