BUILDTORRENT(1) 						   User Commands						   BUILDTORRENT(1)

NAME

       buildtorrent - a torrent file creation program.

SYNOPSIS

       buildtorrent [OPTIONS] -a announceurl input output
       buildtorrent [OPTIONS] -a announceurl -f filelist -n name output

DESCRIPTION

       buildtorrent  is  a  torrent file creation program.  Given an announce url and an input file or directory, buildtorrent generates an output
       .torrent file that can be used by torrent clients.

OPTIONS

       -a announce, --announce=url
	      Announce URL (required).

       -f filelist, --filelist=filelist
	      A text file (or - for standard input) containing a list of files to add to the output torrent file, together with the  path  to  use
	      inside the torrent.  One file is given per line, use / as path separator for the torrent path, use | to separate the filesystem path
	      from the torrent path.  Backslash  can be used to escape newlines and | characters inside names.  For example:

	      /data/files/linux.iso|bin/linux.iso
	      /data/files/linux.txt|doc/linux.txt

	      Using this option requires that the --name option be used.

       -n name, --name=name
	      Specify the name for the torrent.  Usage of this option is required when the --filelist option is used, in which case  it  specifies
	      the name of the torrent directory.  Usage without a file list overrides the name of the directory or file given on the command line.

       -A announces, --announcelist=announces
	      Additional announce URL list.  Use , to separate outer level lists, and | to separate inner level items; for example:

	      a,b1|b2,c

       -w webseeds, --webseeds=webseeds
	      Additional WebSeed URL list.  Use , to separate items; for example:

	      a,b,c

       -l length, --piecelength=length
	      Piece length in bytes (default 262144).

       -L length, --piecesize=size
	      Use 2^size as piece length (default 18) (overrides -l ).

       -c comment, --comment=comment
	      User comment (omitted by default).

       -p private, --private=private
	      Private flag (either 0 or 1).

       -D, --nodate
	      Omit the creation date field.

       -C, --nocreator
	      Omit the created by field.

       -m, --md5sum
	      Add an md5sum field for each file.

       -s, --show
	      Show generated torrent structure.

       -S, --showall
	      Show generated torrent structure, including piece data.

       -q, --quiet
	      Quiet operation with reduced output.

       -V, --version
	      Show the version string.

       -h, --help
	      Show a help screen with brief usage information.

AUTHORS

       Claude Heiland-Allen (claudiusmaximus@goto10.org)

SEE ALSO

       createtorrent(1), mktorrent(1)
       http://wiki.theory.org/BitTorrentSpecification
       http://bittorrent.org/beps/bep_0012.html
       http://www.getright.com/seedtorrent.html

0.8								   January 2010 						   BUILDTORRENT(1)