2008-07-21 16:11:47 +00:00
.Dd July 21 , 2008
2007-04-18 16:39:10 +00:00
.Dt TRANSMISSION-DAEMON 1
.Sh NAME
.Nm transmission-daemon
.Nd a bittorrent client
.Sh SYNOPSIS
2007-05-24 03:59:53 +00:00
.Bk -words
2007-04-18 16:39:10 +00:00
.Nm transmission-daemon
.Fl h
.Nm
2008-12-23 23:54:53 +00:00
.Op Fl a Ar x.x.x.x,...
2008-07-21 16:11:47 +00:00
.Op Fl b | B
2009-02-27 21:49:31 +00:00
.Op Fl c Ar directory
.Op Fl C
2013-05-25 23:20:20 +00:00
.Op Fl d
2008-06-11 20:09:36 +00:00
.Op Fl f
2008-05-19 15:50:30 +00:00
.Op Fl g Ar directory
2008-06-11 20:09:36 +00:00
.Op Fl h
2008-05-19 15:50:30 +00:00
.Op Fl p Ar port
2008-07-21 16:11:47 +00:00
.Op Fl t | T
2008-06-11 20:09:36 +00:00
.Op Fl u Ar username
2008-07-08 17:44:33 +00:00
.Op Fl v Ar password
2008-12-30 18:18:34 +00:00
.Op Fl P Ar port
.Op Fl m | M
.Op Fl l Ar limit
.Op Fl L Ar limit
.Op Fl er | ep | et
2011-04-20 23:17:10 +00:00
.Op Fl utp | no-utp
2009-01-23 19:36:34 +00:00
.Op Fl V
2008-07-08 17:44:33 +00:00
.Op Fl w Ar download-dir
2010-02-11 01:37:59 +00:00
.Op Fl e Ar logfile
2022-03-18 17:59:45 +00:00
.Op Fl x Ar pid-file
2010-09-22 22:19:21 +00:00
.Op Fl log-error | log-info | log-debug
2007-05-24 03:59:53 +00:00
.Ek
2007-04-18 16:39:10 +00:00
.Sh DESCRIPTION
.Nm
2008-05-19 16:16:38 +00:00
is a daemon-based Transmission session that can be controlled
2008-07-21 16:11:47 +00:00
via RPC commands from transmission's web interface or
.Xr transmission-remote 1 .
.Sh OPTIONS
2007-04-18 16:39:10 +00:00
.Bl -tag -width Ds
2008-10-01 20:23:57 +00:00
.It Fl a Fl -allowed Ar x.x.x.x,...
2008-12-23 23:54:53 +00:00
Allow RPC access to a comma-delimited whitelist of IP addresses.
2008-09-26 16:51:12 +00:00
Wildcards can be specified in an address by using '*'.
2017-01-28 20:18:38 +00:00
Default: "127.0.0.1,::1"
2008-10-01 20:23:57 +00:00
Example: "127.0.0.*,192.168.1.*"
2008-06-11 20:09:36 +00:00
.It Fl b Fl -blocklist
2010-12-12 16:36:46 +00:00
Enable peer blocklists. Transmission understands the bluetack blocklist file format.
2008-06-11 20:09:36 +00:00
New blocklists can be added by copying them into the config-dir's "blocklists" subdirectory.
2009-02-27 21:49:31 +00:00
.It Fl c Ar directory
2010-12-12 16:36:46 +00:00
Directory to watch for new .torrent files to be added. As they are added to this directory,
2009-02-27 21:49:31 +00:00
the daemon will load them into Transmission.
.It Fl C
Do not watch for new .torrent files.
2008-07-08 17:44:33 +00:00
.It Fl B Fl -no-blocklist
2022-04-04 18:37:35 +00:00
Disable blocklists.
2013-05-25 23:20:20 +00:00
.It Fl d
Dump transmission-daemon's settings to stderr.
2007-04-18 16:39:10 +00:00
.It Fl f Fl -foreground
2008-06-11 20:09:36 +00:00
Run in the foreground and print errors to stderr.
2008-05-19 15:50:30 +00:00
.It Fl g Fl -config-dir Ar directory
2010-12-12 16:36:46 +00:00
Where to look for configuration files. This can be used to swap between using the cli, daemon, gtk, and qt clients.
2022-04-25 23:18:35 +00:00
See https://github.com/transmission/transmission/blob/main/docs/Configuration-Files.md for more information.
2008-12-30 18:18:34 +00:00
.It Fl er Fl -encryption-required
Encrypt all peer connections.
.It Fl ep Fl -encryption-preferred
Prefer encrypted peer connections.
.It Fl et Fl -encryption-tolerated
Prefer unencrypted peer connections.
2010-02-07 19:20:00 +00:00
.It Fl gsr Fl -global-seedratio Ar ratio
All torrents, unless overridden by a per-torrent setting, should seed until a specific
.Ar ratio
.It Fl GSR Fl -no-global-seedratio
All torrents, unless overridden by a per-torrent setting, should seed regardless of ratio
2007-04-18 16:39:10 +00:00
.It Fl h Fl -help
Print command-line option descriptions.
2010-02-07 19:20:00 +00:00
.It Fl -incomplete-dir Ar dir
When adding new torrents, store their contents in
.Ar directory
until the torrent is done.
.It Fl -no-incomplete-dir
Don't store incomplete torrents in a different directory.
2009-04-15 21:05:58 +00:00
.It Fl i Fl -bind-address-ipv4
Listen for IPv4 BitTorrent connections on a specific address. Only one IPv4 listening address is allowed. Default: 0.0.0.0 (All addresses)
.It Fl I Fl -bind-address-ipv6
Listen for IPv6 BitTorrent connections on a specific address. Only one IPv6 listening address is allowed. Default: :: (All addresses)
.It Fl r Fl -rpc-bind-address
2017-01-28 20:18:38 +00:00
Listen for RPC connections on a specific address. This must be an IPv4 or IPv6 address. Only one RPC listening address is allowed. Default: 0.0.0.0 (All IPv4 addresses)
2009-05-13 19:58:04 +00:00
.It Fl -paused
Pause all torrents on startup
2008-12-30 18:18:34 +00:00
.It Fl L Fl -peerlimit-global Ar limit
Overall peer limit. Useful on embedded systems where the default might be unsuitable. Default: 240
.It Fl l Fl -peerlimit-torrent Ar limit
Peer limit per torrent. Useful on embedded systems where the default might be unsuitable. Default: 60
.It Fl m Fl -portmap
Enable portmapping via NAT-PMP or UPnP
.It Fl M Fl -no-portmap
Disable portmapping
2010-02-07 19:20:00 +00:00
.It Fl o Fl -dht
Enable distributed hash table (DHT).
.It Fl O Fl -no-dht
2022-04-04 18:37:35 +00:00
Disable distributed hash table (DHT).
2008-05-19 15:50:30 +00:00
.It Fl p Fl -port Ar port
2010-12-12 16:36:46 +00:00
Port to open and listen for RPC requests on. Default: 9091
2017-11-15 00:07:50 +00:00
.It Fl P Fl -peerport Ar port
2008-12-30 18:18:34 +00:00
Port to listen for incoming peers on. Default: 51413
2008-06-11 20:09:36 +00:00
.It Fl t Fl -auth
Require clients to authenticate themselves.
This doesn't do much good unless
2008-07-08 17:44:33 +00:00
.Ar username
and
.Ar password
are also set.
.It Fl T Fl -no-auth
2008-06-11 20:09:36 +00:00
Don't require authentication from clients.
2008-07-08 17:44:33 +00:00
.It Fl u Fl -username Ar username
2008-06-11 20:09:36 +00:00
Used for client authentication.
2008-07-08 17:44:33 +00:00
.It Fl v Fl -password Ar password
2008-06-11 20:09:36 +00:00
Used for client authentication.
2009-01-23 19:36:34 +00:00
.It Fl V Fl -version
Show version number and exit
2011-04-20 23:17:10 +00:00
.It Fl -utp
Enable uTP for peer connections.
.It Fl -no-utp
Disable uTP for peer connections.
2008-07-08 17:44:33 +00:00
.It Fl w Fl -download-dir
Where to store downloaded data.
2010-02-11 01:37:59 +00:00
.It Fl e Fl -logfile
Where to store transmission's log messages.
2023-10-01 23:21:14 +00:00
.It Fl -log-level Ar level
Log level. Must be 'critical', 'error', 'warn', 'info', 'debug', or 'trace'.
2010-09-22 22:19:21 +00:00
.It Fl -log-error
2023-10-01 23:21:14 +00:00
Deprecated. Use --log-level=error
2010-09-22 15:23:44 +00:00
.It Fl -log-info
2023-10-01 23:21:14 +00:00
Deprecated. Use --log-level=info
2010-09-22 15:23:44 +00:00
.It Fl -log-debug
2023-10-01 23:21:14 +00:00
Deprecated. Use --log-level=debug
2022-03-18 17:59:45 +00:00
.It Fl x Fl -pid-file
Name of PID file
2007-04-18 16:39:10 +00:00
.El
2008-05-19 16:16:38 +00:00
.Sh ENVIRONMENT
.Bl -tag -width Fl
2010-12-11 21:33:25 +00:00
.It Ev http_proxy
2010-12-16 16:19:19 +00:00
libcurl uses this environment variable when performing tracker announces.
2008-05-19 16:16:38 +00:00
.It Ev TRANSMISSION_HOME
Sets the default config-dir.
.El
2007-04-18 16:39:10 +00:00
.Sh FILES
2008-06-09 15:06:48 +00:00
.Bl -tag -width Ds -compact
.It ~/.config/transmission-daemon
The config-dir used when neither
.Op Ev TRANSMISSION_HOME
nor
.Op Fl g
is specified.
2022-04-25 23:18:35 +00:00
See https://github.com/transmission/transmission/blob/main/docs/Configuration-Files.md for more information.
2008-06-09 15:06:48 +00:00
.El
2007-04-18 16:39:10 +00:00
.Sh AUTHORS
.An -nosplit
2020-05-02 16:42:18 +00:00
.An Charles Kerr ,
2008-05-18 16:44:30 +00:00
.An Josh Elsasser ,
.An Eric Petit ,
2017-01-14 22:37:51 +00:00
.An Mitchell Livingston ,
2007-04-18 16:39:10 +00:00
and
2017-01-14 22:37:51 +00:00
.An Mike Gelfand .
2007-04-18 16:39:10 +00:00
.Sh SEE ALSO
2010-08-04 23:17:49 +00:00
.Xr transmission-create 1 ,
.Xr transmission-daemon 1 ,
.Xr transmission-edit 1 ,
.Xr transmission-gtk 1 ,
.Xr transmission-qt 1 ,
.Xr transmission-remote 1 ,
.Xr transmission-show 1
2007-04-18 16:39:10 +00:00
.Pp
2016-10-31 09:00:11 +00:00
https://transmissionbt.com/
