Changes between Initial Version and Version 1 of EditingConfigurationParameters

Timestamp:

Jan 21, 2010, 5:59:05 PM (12 years ago)

Author:

kim

Comment:

--

EditingConfigurationParameters

@@ +1 @@
+= 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 [ConfigFiles Configuration Files] page.
+See the list of [wiki:ConfigurationParameters 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-Server ==
+
+GTK, CLI and Daemon (both on a Mac and Linux) use a [http://www.json.org/ JSON] formatted file, mainly because of its human readability. [[BR]]
+(Consult the [http://www.json.org/ JSON] for detailed information)
+
+=== Reload Settings ===
+You can make the daemon reload the settings file by sending it the {{{SIGHUP}}} signal.[[BR]]
+Or, simply run either of the following commands:
+{{{
+$ killall -HUP transmission-daemon
+}}}
+Or:
+{{{
+$ pkill -HUP transmission-daemon
+}}}
+However bear in mind that if you edit settings whilst the daemon is running they may be overwritten.
+
+=== Formatting ===
+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.*.*"
+}
+}}}
+
+
+== Mac OS X  ==
+
+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 [http://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man1/defaults.1.html 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''
+
+