= Editing Configuration Files =
[[PageOutline]]

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 [ConfigFiles Configuration Files] page.

== Mac OS X  ==
=== Overview ===

Mac OS X has a standardized way of saving user preferences files using [http://en.wikipedia.org/wiki/XML XML] format. These files are called [http://en.wikipedia.org/wiki/Plist plist] (short for property list) files. Usually there is no need to modify these files directly, since Apple provided a comand-line tool to reliably change settings.

Although the Mac client allows you to set all preferences through the gui, I'll show you how you can switch the updater to use the nightly feed:
{{{
$ defaults write org.m0k.transmission SUFeedURL http://transmission.xpjets.com/ZIP/
}}}
  (Note: These are untested snapshots. Use them with care.)

Use the following to reset the setting:
{{{
$ defaults delete org.m0k.transmission SUFeedURL
}}}
For more information, open up your terminal and type:
{{{
$ man defaults
}}}

== GTK / Daemon / CLI ==
=== Overview ===

GTK, CLI and Daemon (both on a Mac and Linux) use a [http://www.json.org/ JSON] formatted file. Mainly because of it's human readability. [[BR]]
(Consult the [http://www.json.org/ JSON] for detailed information)

Here is a sample of the three basic types, respectively Boolean, Number and String:
{{{
{
    "rpc-enabled": 1,
    "peer-port" : 9091,
    "rpc-whitelist": "127.0.0.*,192.168.*.*"
}
}}}

=== Options ===
==== [wiki:ConfigFiles Location] ====
 * '''download-dir:''' String
==== Bandwidth ====
 * '''download-limit:''' Number (kb/s, default = 100)
 * '''download-limit-enabled:''' Boolean (default = 0)
 * '''upload-limit:''' Number (kb/s, default = 100)
 * '''upload-limit-enabled:''' Boolean (default = 0)
==== Peer Port ====
 * '''peer-port:''' Number (default = 51413)
 * '''port-forwarding-enabled:''' Boolean (0-1)
 * '''peer-port-random-enabled:''' Boolean (default = 0)
 * '''peer-port-random-low:''' Number (default = 1024)
 * '''peer-port-random-high:''' Number (default = 65535)
==== [wiki:Blocklists] ====
 * '''blocklist-enabled:''' Boolean (default = 0)
==== [wiki:rpc RPC] ====
 * '''rpc-enabled:''' Boolean (default = 1)
 * '''rpc-port:''' Number (default = 9091)
 * '''rpc-authentication-required:''' Boolean (default = 0)
 * '''rpc-username:''' String
 * '''rpc-password:''' String
 * '''rpc-whitelist-enabled:''' Boolean (default = 1)
 * '''rpc-whitelist:''' String (Comma-delimited list of IP addresses. Wildcards allowed using '*'. Example: "127.0.0.*,192.168.*.*", Default:  "127.0.0.1" )
==== Peers ====
 * '''peer-limit-global:''' Number (default = 240)
 * '''peer-limit-per-torrent:''' Number (default =  60)
==== Advanced ====
 * '''pex-enabled:''' Boolean (default =  1)
 * '''encryption:''' Number (0 = Off, 1 = Preferred, 2 = Forced, default = 1)
 * '''lazy-bitfield-enabled:''' Boolean (default =  1)
 * '''peer-socket-tos:''' Number (default = 8)
==== Proxy ====
 * '''proxy-enabled:''' Boolean (default = 0)
 * '''proxy:''' String
 * '''proxy-port:''' Number (default = 80)
 * '''proxy-type:''' Number (0 = HTTP, 1 = SOCKS4, 2 = SOCKS5, default = 0)
 * '''proxy-auth-enabled:''' Boolean (default = 0)
 * '''proxy-auth-username:''' String
 * '''proxy-auth-password:''' String

=== Legacy Options ===
Only keys that differ from above are listed here.
==== 1.4x Options ====
===== Proxy =====
 * '''proxy-server:''' String
 * '''proxy-port:''' Number (default = 80)
 * '''proxy-server-enabled:''' Boolean (default = 0)
 * '''proxy-type:''' Number (0 = HTTP, 1 = SOCKS4, 2 = SOCKS5, default = 0)
 * '''proxy-authentication-required:''' Boolean (default = 0)
 * '''proxy-username:''' String
 * '''proxy-authentication''' String
===== Peers =====
 * '''max-peers-global:''' Number (default = 240)
 * '''max-peers-per-torrent:''' Number (default =  60)

==== 1.3x Options ====
 * '''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" )