btreannounce — change the announce address of a torrent file
btreannounce trackerURL file [file ...] [--announce_list
This manual page documents briefly the btreannounce command.
This manual page was written for the Debian distribution because the
original program does not have a manual page.
btreannounce is a program which will change the announce address of a
existing torrent file. The already existing torrent specified by the
file argument will be modified to use the new announce url given by the
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (‘--’). A summary of options is
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
Try the three trackers (1-3) in sequential order:
btreannounce trackerURL file --announce_list http://track1.com|http://track2.com|http://track3.com
Try the three trackers (1-3) in a randomly selected order:
btreannounce trackerURL file --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)
btreannounce trackerURL file --announce_list http://track1.com|http://track2.com,http://track3.com
btcopyannounce(1), btrename(1), btsethttpseeds(1), btshowmetainfo(1),
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.