&dhucpackage; &dhsection;

&dhpackage;

change the announce address of a torrent file

          &dhpackage;

           trackerURL
          file
          file
          --announce_list announceURLlist

## DESCRIPTION

This manual page documents briefly the `&dhpackage;` command.

This manual page was written for the &debian; distribution because the original program does not have a manual page.

`&dhpackage;` 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 `trackerURL` argument.

## OPTIONS

These programs follow the usual &gnu; command line syntax, with long options starting with two dashes (`--'). A summary of options is included below.

`--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:

    &dhpackage; trackerURL file --announce_list http://track1.com|http://track2.com|http://track3.com

Try the three trackers (1-3) in a randomly selected order:

    &dhpackage; 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) randomly:

    &dhpackage; trackerURL file --announce_list http://track1.com|http://track2.com,http://track3.com

## SEE ALSO

btcopyannounce

1,

btrename

1,

btsethttpseeds

1,

btshowmetainfo

1,

bittorrent-downloader

1.

## AUTHOR

This manual page was written by &dhusername; <&dhemail;> (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.