bttrack - tracker for bittornado

bttrack --dfile <file> [--port portnum] [--bind ip,ip,ip] [--ipv6_enabled 0 | 1 ] [--ipv6_binds_v4 0 | 1 ] [--socket_timeout seconds] [--save_dfile_interval seconds] [--timeout_downloaders_interval seconds] [--reannounce_interval seconds] [--response_size num] [--timeout_check_interval seconds] [--nat_check num] [--log_nat_checks 0 | 1 ] [--min_time_between_log_flushes seconds] [--min_time_between_cache_refreshes seconds] [--allowed_dir directory] [--allowed_controls 0 | 1 ] [--multitracker_enabled 0 | 1 ] [--multitracker_allowed autodetect | none | all ] [--multitracker_reannounce_interval seconds] [--multitracker_maxpeers num] [--aggregate_forward url[,<password>]] [--aggregator 0 | 1 | <password> ] [--hupmonitor 0 | 1 ] [--http_timeout seconds ] [--parse_dir_interval seconds] [--show_infopage 0 | 1 ] [--infopage_redirect URL] [--show_names 0 | 1] [--favicon filename] [--allowed_ips file] [--only_local_override_ip 0 | 1 | 2 ] [--logfile file] [--allow_get 0 | 1] [--keep_dead 0 | 1] [--scrape_allowed full | specific | none]...

bttrack is a "tracker" for bittorrent clients. This program keeps track of the completion of each client, and communicates that information when requested to other clients.

This program follows the usual GNU command-line syntax, with long options starting with two dashes ('-'). A summary of options is included below.

--port portnum

portnum to listen on. (defaults to 80)

--dfile filename

filename to store recent downloader info in

--bind ip,ip,ip

comma-separated list of ips/hostnames to bind to locally (defaults to '')

--ipv6_enabled 0 | 1

allow the client to connect to peers via IPv6 (defaults to 0)

--ipv6_binds_v4 0 | 1

set if an IPv6 server socket will also field IPv4 connections (defaults to 1)

--socket_timeout seconds

seconds timeout for closing connections (defaults to 15)

--save_dfile_interval seconds

seconds between saving dfile (defaults to 300)

--timeout_downloaders_interval seconds

seconds between expiring downloaders (defaults to 2700)

--reannounce_interval seconds

seconds downloaders should wait between reannouncements (defaults to 1800)

--response_size num

num of peers to send in an info message (defaults to 50)

--timeout_check_interval seconds

time in seconds to wait between checking if any connections have timed out (defaults to 5)

--nat_check num

num times to check if a downloader is behind a NAT (0 = don't check) (defaults to 3)

--log_nat_checks 0 | 1

whether to add entries to the log for nat-check results (defaults to 0)

--min_time_between_log_flushes seconds

minimum time in seconds it must have been since the last flush to do another one (defaults to 3.0)

--min_time_between_cache_refreshes seconds

minimum time in seconds before a cache is considered stale and is flushed (defaults to 600.0)

--allowed_dir directory

only allow downloads for .torrents in this directory (defaults to '')

--allowed_controls 0 | 1

allow special keys in torrents in the allowed_dir to affect tracker access (defaults to 0)

--multitracker_enabled 0 | 1

whether to enable multitracker operation (defaults to 0)

--multitracker_allowed autodetect | none | all

whether to allow incoming tracker announces (can be none, autodetect or all) (defaults to 'autodetect')

--multitracker_reannounce_interval seconds

number of seconds between outgoing tracker announces (defaults to 120)

--multitracker_maxpeers num

num of peers to get in a tracker announce (defaults to 20)

--aggregate_forward url[,<password>]

if set, forwards all non-multitracker to this url with this optional password (defaults to '')

--aggregator 0 | 1 | <password>

whether to act as a data aggregator rather than a tracker. If enabled, may be 1, or <password>; if password is set, then an incoming password is required for access (defaults to '0')

--hupmonitor 0 | 1

whether to reopen the log file upon receipt of HUP signal (defaults to 0)

--http_timeout seconds

number of seconds to wait before assuming that an http connection has timed out (defaults to 60)

--parse_dir_interval seconds

seconds between reloading of allowed_dir (defaults to 60)

--show_infopage 0 | 1

whether to display an info page when the tracker's root dir is loaded (defaults to 1)

--infopage_redirect URL

a URL to redirect the info page to (defaults to '')

--show_names 0 | 1

whether to display names from allowed dir (defaults to 1)

--favicon filename

filename containing x-icon data to return when browser requests favicon.ico (defaults to '')

--allowed_ips file

only allow connections from IPs specified in the given file; contains subnet data in the format: aa.bb.cc.dd/len (defaults to '')

--only_local_override_ip 0 | 1 | 2

ignore the ip GET parameter from machines which aren't on local network IPs (0 = never, 1 = always, 2 = ignore if NAT checking is not enabled) (defaults to 2)

--logfile file

file to write the tracker logs, use - for stdout (default) (defaults to '')

--allow_get 0 | 1

use with allowed_dir; adds a /file?hash={hash} url that allows users to download the torrent file (defaults to 0)

--keep_dead 0 | 1

keep dead torrents after they expire (so they still show up on your /scrape and web page) (defaults to 0)

--scrape_allowed full | specific | none

scrape access allowed (can be none, specific or full) (defaults to 'full')

bittorrent-downloader(1), btmakemetafile(1).

This manual page was written by Micah Anderson <micah@riseup.net>, for the Debian GNU/Linux system (but may be used by others).