Version 2 (modified by kim, 12 years ago) (diff)


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. See the list of Configuration Parameters.

Note: The client should be shutdown before making changes, otherwise settings will be reverted to it's previous state.

Transmission-Desktop Linux/GTK, Qt, Transmission-Daemon

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

Reload Settings

You can make the daemon reload the settings file by sending it the SIGHUP signal.

$ killall -HUP transmission-daemon

However bear in mind that if you edit settings whilst the daemon is running they may be overwritten.


There are three basic types:

Type Values
Boolean true, false
Number Integer or Real depending on context
String surround with (double?) quotes

The settings.json format is:

    "KEY"  :  VALUE,    (for a Boolean or Number)
    "KEY"  :  "VALUE"   (for a string)


    "rpc-enabled": true,
    "peer-port" : 51413,
    "rpc-whitelist": ",192.168.*.*"

Mac OS X

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