Common Parameters

The following are common to all current versions of Transmission.

Directories

Option

Kind

Default Value

Description

download-dir

String

default locations

watch-dir

String

Directory to watch for new .torrent files to autoload

watch-dir-enabled

Boolean

false

Enables directory watching and autoload

Bandwidth

Option

Kind

Default Value

Description

speed-limit-down

Number (KB/s)

100

Standard download speed limit (used if enabled)

speed-limit-down-enabled

Boolean

false

Flag to enable the use of speed-limit-down

speed-limit-up

Number (KB/s)

100

Standard upload speed limit (used if enabled). May need to be set for best performance

speed-limit-up-enabled

Boolean

false

Flag to enable the use of speed-limit-up

alt-speed-enabled

Boolean

false

Enable alternate Speed limits (aka 'Turtle Mode'). Manual "Turtle" mode changes in the gui when the scheduler is enabled, will be reset at the next scheduled speed change.

alt-speed-up

Number (KB/s)

50

Alternate upload speed limit

alt-speed-down

Number (KB/s)

50

Alternate download speed limit

Scheduling

Option

Kind

Default Value

Description

ratio-limit

Number

2.0

Ratio of uploads:downloads for a torrent before torrent is deemed complete.
Ratio should be at least 1.0 for normal use, 2.0 is considered 'good'

ratio-limit-enabled

Boolean

false

By default torrents will seed forever (ie Ratio -> infinity)

alt-speed-time-enabled

Boolean

false

Note: When enabled, this will toggle the alt-speed-enabled setting.

alt-speed-time-begin

Number

540 ==9am

Minutes from midnight

alt-speed-time-end

Number

1020 ==5pm

Minutes from midnight

alt-speed-time-day

Number/bitfield

127 == all days

    alt-speed-time-day Start with 0, then for each day you want the scheduler enabled, add:

o  Sunday: 1 (binary: 0000001)

o  Monday: 2 (binary: 0000010)

o  Tuesday: 4 (binary: 0000100)

o  Wednesday: 8 (binary: 0001000)

o  Thursday: 16 (binary: 0010000)

o  Friday: 32 (binary: 0100000)

o  Saturday: 64 (binary: 1000000)

    Examples:

o  Weekdays: 62 (binary: 0111110)

o  Weekends: 65 (binary: 1000001)

o  All Days: 127 (binary: 1111111)

Peer Management

Option

Kind

Default Value

Description

peer-limit-global

Number

240

Maximum number of connected peers

peer-limit-per-torrent

Number

60

Maximum number of connected peers for an individual torrent

blocklist-enabled

Boolean

false

Blocks specified remote peers (via IP address). Refer [Blocklists]

dht-enabled

Boolean

true

Enable Bit Torrent Distributed Hash Table (DHT) operation
(see
 http://en.wikipedia.org/wiki/Distributed_hash_table  Wikipedia:DHT)

encryption

Number

1

Specify encryption mode for Peers: 0 = Off, 1 = Preferred, 2 = Forced

peer-socket-tos

Number

0

pex-enabled

Boolean

true

Enable Bit Torrent Peer EXchange
(see
 http://en.wikipedia.org/wiki/Peer_exchange  Wikipedia:PEX)

Bit Torrent Peer Ports

Option

Kind

Default Value

Description

peer-port

Number

51413

Port to listen on for incoming Peer connections

peer-port-random-enabled

Boolean

false

If true then assign a random peer-port between the -low and -high values.

peer-port-random-low

Number

1024

Lowest permitted value for a randomly assigned peer-port

peer-port-random-high

Number

65535

Highest permitted value for a randomly assigned peer-port

port-forwarding-enabled

Boolean

true

Enable uPnP and XXX protocols to try and negotiate opening of selected peer-port with firewalls that support such negotiation. Security conscious or advanced users may want to disable this feature.

Proxy

Option

Kind

Default Value

Description

proxy

String

URL of proxy server

proxy-enabled

Boolean

false

If true operate through the proxy server with the specified settings

proxy-auth-enabled

Boolean

false

Enable use of proxy authentication (ie username/password)

proxy-auth-username

String

Username for proxy access

proxy-auth-password

String

Password for proxy access

proxy-port

Number

80

Port on which to contact the proxy server

proxy-type

Number

0

Type of proxy connection: (0 = HTTP, 1 = SOCKS4, 2 = SOCKS5)

Remote Control

Option

Kind

Default Value

Description

rpc-enabled

Boolean

true

Enables remote control services

rpc-authentication-required

Boolean

false

If set, then a username and password are required to access the remote control services

rpc-password

String

-

The ssha1 encrypted password (starts with a '{') needed for remote access.
A new password can be entered via command line utilities or directly in plain text and will replaced with the encrypted version when the configuration file is next saved.

rpc-port

Number

9091

The port Transmission listens on for remote services

rpc-username

String

The username required to access remote services when rpc-authentication-required is enabled

rpc-whitelist

String

"127.0.0.1"

Comma-delimited list of IP addresses from which remote control is permitted.
Wildcards are allowed using '*'. Example: "127.0.0.*,192.168.*.*".

rpc-whitelist-enabled

Boolean

true

If enabled use rpc-whitelist. Other IP addresses will be denied remote access

Advanced

Option

Kind

Default Value

Description

lazy-bitfield-enabled

Boolean

true

open-file-limit

Number

32

Maximum number of open files XXXX

rename-partial-files

Boolean

true

If enabled partially downloaded files are appended with ".part"

preallocation

Number

1

0 = Off, 1 = Fast, 2 = Full (slower but reduces disk fragmentation)

umask

Number

18

Sets transmission's file mode creation mask. See  the umask(2) manpage. For world-writable torrents set umask to 0.
Note: JSON only accepts base 10 numbers, so convert standard octal umask to base 10, "022" is thus written as 18.