Transmission/transmission
1
0
Fork 0
mirror of https://github.com/transmission/transmission.git synced 2025-12-20 02:18:42 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
fcd1e2ff8a1535f69f6d3f9e365c6a952e7d1206
transmission/docs/Environment-Variables.md
Charles Kerr 9a792046f3 feat: add libtransmission::api_compat::convert() (#7917) 
Add a module to convert between tr4 and tr5 RPC / settings / config file payloads.

This will be used as a compatibility layer between Transmission 5's naming scheme
and Transmission <= 4.

Co-authored-by: Yat Ho <lagoho7@gmail.com>
Co-authored-by: Dzmitry Neviadomski <nevack.d@gmail.com>
2025-12-14 10:56:07 -06:00

2.5 KiB
Raw Blame History

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_SSL_NO_VERIFY is set, Transmission will not validate SSL certificate for HTTPS connections when talking to trackers. See CURL's documentation (CURLOPT_SSL_VERIFYHOST and CURLOPT_SSL_VERIFYPEER) for more details.
  • If TR_CURL_VERBOSE is set, debugging information for libcurl will be enabled. More information about libcurl's debugging mode is available here.
  • If TR_DHT_VERBOSE is set, Transmission will log all of the DHT's activities in excruciating detail to standard error.
  • If TR_SAVE_VERSION_FORMAT is set to 4 or 5, it will save settings.json, stats.json, etc. files to either Transmission 4 or Transmission 5 format.

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 is 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 does not support proxies, but libcurl itself honors a handful of environment variables to customize its proxy behavior.
Reference in New Issue View Git Blame Copy Permalink