From eb51051900c76df82316b04dd1e0c28bf079bf5a Mon Sep 17 00:00:00 2001 From: Mike Gelfand Date: Sat, 3 Sep 2016 14:46:08 +0300 Subject: [PATCH] Created Configuration Files (markdown) --- Configuration-Files.md | 51 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 Configuration-Files.md diff --git a/Configuration-Files.md b/Configuration-Files.md new file mode 100644 index 0000000..5f27089 --- /dev/null +++ b/Configuration-Files.md @@ -0,0 +1,51 @@ +## Locations + +### Mac OS X Defaults + +Per-torrent settings are stored in `~/Library/Application Support/Transmission` +Application settings are stored in `~/Library/Preferences/org.m0k.transmission.plist` +The default download folder is `~/Downloads` + +### Linux / GTK Defaults + +For the GTK+ client, all settings are kept in `$HOME/.config/transmission` +For the Daemon, all settings are kept in `$HOME/.config/transmission-daemon` +For the CLI, all settings are kept in `$HOME/.config/transmission-cli` +The default download folder is `$HOME/Downloads` + +Some Linux distributions' start script for transmission-daemon use different location. This varies by distribution, but two paths sometimes used are `/var/lib/transmission-daemon` and `/var/run/transmission`. +Locations for [[Debian|UnixServer/Debian]] and its derivatives (e.g. Ubuntu). + +If you want to swap between the two applications, all you have to do is pass in a different config directory with the -g command-line option. For example, to have the daemon pick up where the gtk+ client left off, run `transmission-daemon -g ~/.config/transmission`. + +### Overriding the Defaults + +The per-user configuration folder's location can be overridden by setting `TRANSMISSION_HOME` and/or other [[environment variables|EnvironmentVariables]]. + +## Files + +The configuration folder typically has the following files: + +### settings.json + +This is a json-encoded file that holds all the client's settings and preferences. It's currently only used by the daemon, GTK+ and CLI clients. json was chosen because it's mostly human-readable and -writable, but also allows data hierarchies to be stored. See the [[Editing Configuration Files|EditConfigFiles]] page on how to modify them. + +### stats.json + +This is a json-encoded file that holds session statistics such as running upload and download byte counts. + +### torrents/ + +This subfolder holds the .torrent files that have been added to Transmission. The files in this folder are named with a combination of the torrent's name (to make it human-readable) and a portion of the torrent's SHA1 hash (to avoid filename collisions from similarly-named torrents). + +### resume/ + +This subfolder holds .resume files that hold information about a particular torrent, such as which parts have been downloaded, the folder the downloaded data was stored in, and so on. These follow an identical naming scheme to the files in the torrents subfolder. + +### blocklists/ + +This subfolder holds bluetack-formatted blocklists. Files ending in ".bin" are generated by Transmission as it parses a bluetack file and stores it into a binary format for faster lookups. On startup, Transmission will try to parse any non-".bin" file and generate a new blocklist from it, so you can have multiple blocklists just by copying new bluetack files into this location. See [[Blocklists]] for more information. + +## Legacy Versions of Transmission + +Older, [pre-XDG](http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html) [versions](http://trac.transmissionbt.com/ticket/684) of transmission-gtk and transmission-daemon stored their settings in `$HOME/.transmission`. Newer releases try to automatically migrate these files to `$HOME/.config/transmission/`. \ No newline at end of file