---
name: "btreannounce.bittornado"
section: "1"
platform: "linux"
package: "bittornado"
version: "0.3.18-10.3"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/btreannounce.bittornado"
---

# btreannounce.bittornado(1)

change the announce address of a torrent file

## NAME

btreannounce — change the announce address of a torrent file

## SYNOPSIS

**btreannounce**  *trackerURL* *file* \[*file* ...\]  \[**--announce\_list** *announceURLlist\]*

## DESCRIPTION

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

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

```
btreannounce trackerURL file --announce_list http://track1.com|http://track2.com,http://track3.com
```

## SEE ALSO

**[btcopyannounce(1)](/btcopyannounce/1.md)**,  **btrename(1)**,  **[btsethttpseeds(1)](/btsethttpseeds/1.md)**,  **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.