mirror
/
transmission
mirror of https://github.com/transmission/transmission
1
0
Fork 0
Code Issues Releases Wiki Activity
Page: Environment Variables
Pages
Blocked Traffic Blocklists Bug Submission Building Transmission Can I sequence the files I download Configuration Files Editing Configuration Files Environment Variables Home Peer ID and User Agent Peer Status Text Previous Releases RPC Protocol Specification Release Notes Translating Transmission Architecture Transmission Resume Files Transmission is Downloading Files I Asked It To Not Download Web Interface Why Are My Speeds So Slow? Why is my port closed?
1 Environment Variables
Mike Gelfand edited this page 2016-09-03 15:27:20 +03:00
Table of Contents

Users can set environmental variables to override Transmission's default behavior and for debugging.

Transmission-Specific Variables

  • If TRANSMISSION_HOME is set, Transmission will look there for its settings instead of in the default location.

  • If TRANSMISSION_WEB_HOME is set, Transmission will look there for the Web Interface files, such as the javascript, html, and graphics files.

  • If TR_CURL_VERBOSE is set, debugging information for libcurl will be enabled. More information about libcurl's debugging mode is available here.

  • TR_DEBUG (undocumented).

  • If TR_DEBUG_FD is set to an integer, that integer is treated as a file descriptor and very verbose debugging information is written to it. For example, here is how to turn on debugging and save it to a file named "runlog" when running Transmission from a bash shell:

    $ export TR_DEBUG_FD=2
$ transmission 2>runlog

  • If TR_DHT_VERBOSE is set, then Transmission will log all of the DHT's activities in excrutiating detail to standard error.

Standard Variables Used By Transmission

  • If TRANSMISSION_WEB_HOME is not set, non-Mac platforms will look for the Web Interface files in XDG_DATA_HOME and in XDG_DATA_DIRS as described in the XDG Base Directory Specification. XDG_DATA_HOME has a default value of $HOME/.local/share/.
  • If TRANSMISSION_HOME is not set, Unix-based versions of Transmission will look for their settings in $XDG_CONFIG_HOME/transmission/. XDG_CONFIG_HOME has a default value of $HOME/.config/.
  • If HOME is set, it's used in three ways:
    1. by the XDG variables, as described above
    2. If TRANSMISSION_HOME is not set, Mac-based versions of Transmission will look for their settings in $HOME/Library/Application Support/Transmission
    3. $HOME/Downloads is the default download directory.

Standard Variables Used By Other Tools

  • Transmission uses the libcurl library for http- and https-based tracker announces and scrapes. Transmission doesn't support proxies, but libcurl itself honors a handful of environment variables to customize its proxy behavior.