Editing Configuration Files

It's not always possible to set all configurations from the GUI, especially on the Daemon, or the Web Interface. This guide will try to give an overview of how and what you can change. For the location of these files, look at the Configuration Files page.

GTK / Daemon / CLI

Overview

GTK, CLI and Daemon (both on a Mac and Linux) use a ​JSON formatted file, mainly because of it's human readability.
(Consult the ​JSON for detailed information)

Here is a sample of the three basic types, respectively Boolean, Number and String:

{
    "rpc-enabled": 1,
    "peer-port" : 51413,
    "rpc-whitelist": "127.0.0.1,192.168.*.*"
}

Options

Advanced

• encryption: Number (0 = Off, 1 = Preferred, 2 = Forced, default = 1)
• lazy-bitfield-enabled: Boolean (default = true)
• open-file-limit: Number (default = 32)
• peer-socket-tos: Number (default = 0)
• pex-enabled: Boolean (default = true)
• dht-enabled: Boolean (default = true)
• preallocation: Number (0 = Off, 1 = Fast, 2 = Full (slower but reduces disk fragmentation), default = 1)

Bandwidth

• download-limit: Number (kb/s, default = 100)
• download-limit-enabled: Boolean (default = false)
• upload-limit: Number (kb/s, default = 100)
• upload-limit-enabled: Boolean (default = false)
• alt-speed-enabled: Boolean (default = false, aka 'Turtle Mode')
• alt-speed-up: Number (default = 50)
• alt-speed-down: Number (default = 50)

Blocklists

• blocklist-enabled: Boolean (default = false)

Location

• download-dir: String

Peers

• peer-limit-global: Number (default = 240)
• peer-limit-per-torrent: Number (default = 60)

Peer Port

• peer-port: Number (default = 51413)
• peer-port-random-enabled: Boolean (default = false)
• peer-port-random-high: Number (default = 65535)
• peer-port-random-low: Number (default = 1024)
• port-forwarding-enabled: Boolean

Proxy

• proxy: String
• proxy-enabled: Boolean (default = false)
• proxy-auth-enabled: Boolean (default = false)
• proxy-auth-username: String
• proxy-auth-password: String
• proxy-port: Number (default = 80)
• proxy-type: Number (0 = HTTP, 1 = SOCKS4, 2 = SOCKS5, default = 0)

RPC

• rpc-authentication-required: Boolean (default = false)
• rpc-enabled: Boolean (default = true)
• rpc-password: String
• rpc-port: Number (default = 9091)
• rpc-username: String
• rpc-whitelist: String (Comma-delimited list of IP addresses. Wildcards allowed using '*'. Example: "127.0.0.*,192.168.*.*", Default: "127.0.0.1" )
• rpc-whitelist-enabled: Boolean (default = true)

Scheduling

• ratio-limit: Number (default = 2.0)
• ratio-limit-enabled: Boolean (default = false)
• alt-speed-time-enabled: Boolean (default = false)
• alt-speed-time-begin: Number (default = 540, in minutes from midnight, 9am)
• alt-speed-time-end: Number (default = 1020, in minutes from midnight, 5pm)
• alt-speed-time-day: Number/bitfield (default = 127, all days)
  • Start with 0, then for each day you want the scheduler enabled, add:
    • Sunday: 1 (binary: 0000001)
    • Monday: 2 (binary: 0000010)
    • Tuesday: 4 (binary: 0000100)
    • Wednesday: 8 (binary: 0001000)
    • Thursday: 16 (binary: 0010000)
    • Friday: 32 (binary: 0100000)
    • Saturday: 64 (binary: 1000000)
  • Examples:
    • Weekdays: 62 (binary: 0111110)
    • Weekends: 65 (binary: 1000001)
    • All Days: 127 (binary: 1111111)

Legacy Options

Only keys that differ from above are listed here. These options have been replaced in newer versions of Transmission.

1.4x Options

Proxy

• proxy-authentication String
• proxy-authentication-required: Boolean (default = 0)
• proxy-port: Number (default = 80)
• proxy-server: String
• proxy-server-enabled: Boolean (default = 0)
• proxy-type: Number (0 = HTTP, 1 = SOCKS4, 2 = SOCKS5, default = 0)
• proxy-username: String

Peers

• max-peers-global: Number (default = 240)
• max-peers-per-torrent: Number (default = 60)

1.3x Options

RPC

• rpc-access-control-list: String (Comma-delimited list of IP addresses prefixed with "+" or "-". Wildcards allowed using '*'. Example: "+127.0.0.*,-192.168.*.*", Default: "+127.0.0.1" )

Mac OS X

Overview

Mac OS X has a standardized way of saving user preferences files using ​XML format. These files are called ​plist (short for property list) files. Usually there is no need to modify these files directly, since Apple provided a ​command-line tool to reliably change settings. You do need to restart Transmission before these have effect.

In short:

• To set a key: defaults write org.m0k.transmission key value
• To reset a key: defaults delete org.m0k.transmission key

Options

Nightly

Note: Nightlies are untested snapshots. Use them with care.

• SUFeedURL:

  $ defaults write org.m0k.transmission SUFeedURL http://transmission.xpjets.com/ZIP/
  

Advanced

• PeerSocketTOS: Number (Default = 0)