Transmission

transmission

A fast, easy and free BitTorrent client for Mac, Windows and Linux.

Detected by transmission-daemon, transmission-remote, transmission-cli, transmission-gtk, transmission-qt | macOS, Linux, Windows |transmissionbt.com

Sync it transmission.toml

Sync rules

What travels, what stays, what never leaves

Synced5 paths, copied whole to your other machines

[preferences]/org.m0k.transmission.plistpattern

~/.config/transmission/settings.json

~/.config/transmission-daemon/settings.json

%LOCALAPPDATA%/transmission/settings.json

%LOCALAPPDATA%/transmission-daemon/settings.json

Secret fieldsInside a file that otherwise syncs

~/.config/transmission/settings.jsonjson fields at

rpc-password

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

~/.config/transmission-daemon/settings.jsonjson fields at

rpc-password

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

%LOCALAPPDATA%/transmission/settings.jsonjson fields at

rpc-password

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Secret fieldsInside a file that otherwise syncs

%LOCALAPPDATA%/transmission-daemon/settings.jsonjson fields at

rpc-password

The rest of the file syncs. Only these values are lifted out and kept in your secret store.

Stays on this machineInside a file that otherwise syncs

~/.config/transmission/settings.jsonjson fields at

download-dirincomplete-dirwatch-dir

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

~/.config/transmission-daemon/settings.jsonjson fields at

download-dirincomplete-dirwatch-dir

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

%LOCALAPPDATA%/transmission/settings.jsonjson fields at

download-dirincomplete-dirwatch-dir

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Stays on this machineInside a file that otherwise syncs

%LOCALAPPDATA%/transmission-daemon/settings.jsonjson fields at

download-dirincomplete-dirwatch-dir

Otty splits these out before upload and puts each machine’s own back on the way down — no templates to write.

Excluded

Nothing. Transmission writes no caches or state in your home directory.

Transmission in your home directory Every rule on this page, by file

· ~/Library/Preferences/org.m0k.transmission.plist Sync

…

"blocklist-url": "http://www.example.com/blocklist",

"cache-size-mb": 4,

"dht-enabled": true,

"download-dir": "/home/dev/Downloads",machine-local

"download-queue-enabled": true,

"download-queue-size": 5,

"encryption": 1,

"idle-seeding-limit": 30,

"idle-seeding-limit-enabled": false,

"incomplete-dir": "/home/dev/Downloads/.incomplete",machine-local

"incomplete-dir-enabled": true,

"lpd-enabled": false,

"message-level": 2,

…

"umask": 18,

"upload-slots-per-torrent": 14,

"utp-enabled": true,

"watch-dir": "/home/dev/Downloads/watch",machine-local

"watch-dir-enabled": true

}

Each machine keeps its own copy of these.

rpc-password

Lifted into your secret store; the rest of the file syncs.

…

"blocklist-url": "http://www.example.com/blocklist",

"cache-size-mb": 4,

"dht-enabled": true,

"download-dir": "/srv/torrents/complete",machine-local

"download-queue-enabled": true,

"download-queue-size": 5,

"encryption": 1,

"idle-seeding-limit": 30,

"idle-seeding-limit-enabled": false,

"incomplete-dir": "/srv/torrents/incomplete",machine-local

"incomplete-dir-enabled": true,

"lpd-enabled": false,

"message-level": 2,

…

"umask": 18,

"upload-slots-per-torrent": 14,

"utp-enabled": true,

"watch-dir": "/srv/torrents/watch",machine-local

"watch-dir-enabled": true

}

Each machine keeps its own copy of these.

rpc-password

Lifted into your secret store; the rest of the file syncs.

…

"blocklist-url": "http://www.example.com/blocklist",

"cache-size-mb": 4,

"dht-enabled": true,

"download-dir": "C:/Users/dev/Downloads",machine-local

"download-queue-enabled": true,

"download-queue-size": 5,

"encryption": 1,

"idle-seeding-limit": 30,

"idle-seeding-limit-enabled": false,

"incomplete-dir": "C:/Users/dev/Downloads/.incomplete",machine-local

"incomplete-dir-enabled": true,

"lpd-enabled": false,

"message-level": 2,

…

"umask": 18,

"upload-slots-per-torrent": 14,

"utp-enabled": true,

"watch-dir": "C:/Users/dev/Downloads/watch",machine-local

"watch-dir-enabled": true

}

Each machine keeps its own copy of these.

rpc-password

Lifted into your secret store; the rest of the file syncs.

…

"blocklist-url": "http://www.example.com/blocklist",

"cache-size-mb": 4,

"dht-enabled": true,

"download-dir": "D:/Torrents/complete",machine-local

"download-queue-enabled": true,

"download-queue-size": 5,

"encryption": 1,

"idle-seeding-limit": 30,

"idle-seeding-limit-enabled": false,

"incomplete-dir": "D:/Torrents/incomplete",machine-local

"incomplete-dir-enabled": true,

"lpd-enabled": false,

"message-level": 2,

…

"umask": 18,

"upload-slots-per-torrent": 14,

"utp-enabled": true,

"watch-dir": "D:/Torrents/watch",machine-local

"watch-dir-enabled": true

}

Each machine keeps its own copy of these.

rpc-password

Lifted into your secret store; the rest of the file syncs.

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/transmission.tomlThe file this page is generated from

id = "transmission"

name = "Transmission"

homepage = "https://transmissionbt.com"

description = "A fast, easy and free BitTorrent client for Mac, Windows and Linux."

icon = "SimpleIcons:transmission"

# The clients that have a command line; the macOS app has none, so it is

# reached through the paths rather than through a name here.

detect = ["transmission-daemon", "transmission-remote", "transmission-cli", "transmission-gtk", "transmission-qt"]

# The project's own docs/Configuration-Files.md, "Locations", is the source for

# every path below.

# macOS defaults: "Application settings —

# $HOME/Library/Preferences/org.m0k.transmission.plist" (and "Per-torrent

# settings — $HOME/Library/Application Support/Transmission", which is the

# .torrent and .resume store rather than configuration, so it is left out).

# Linux/GTK defaults: "GTK+/Qt client settings — $HOME/.config/transmission",

# "Daemon settings — $HOME/.config/transmission-daemon", "CLI settings —

# $HOME/.config/transmission-cli".

# Windows defaults: "Qt client settings — %LOCALAPPDATA%/transmission",

# "Daemon settings — %LOCALAPPDATA%/transmission-daemon".

# The file inside each of those folders is settings.json: "This is a

# JSON-encoded file that holds all the client's settings and preferences."

# Windows uses %LOCALAPPDATA% where Linux uses the XDG config directory, so

# these are genuinely different places rather than one place under three names

# and each spelling is written out; a consumer skips the ones that do not

# exist. The folder can also be moved with $TRANSMISSION_HOME.

paths = [

"[preferences]/org.m0k.transmission.plist",

"~/.config/transmission/settings.json",

"~/.config/transmission-daemon/settings.json",

"%LOCALAPPDATA%/transmission/settings.json",

"%LOCALAPPDATA%/transmission-daemon/settings.json",

]

# The rest of a configuration folder is state, and none of it is named above:

# stats.json (session byte counters), the lock file, torrents/ and resume/, and

# blocklists/ with its generated .bin files.

exclude = []

# No whole-file credential: settings.json is settings end to end, and the one

# credential in it is a field, named below.

secret = []

# rpc-password is the password for the daemon's web interface and RPC port.

# Transmission rewrites it as a salted hash on the first run after it is set,

# but a hash of the user's password is still the thing that authenticates

# against that daemon, so it is held back rather than synced as content.

# The rule names every spelling of settings.json in `paths`, because a rule

# that named only the Unix one would not run on Windows.

[[secret_paths]]

file = [

"~/.config/transmission/settings.json",

"~/.config/transmission-daemon/settings.json",

"%LOCALAPPDATA%/transmission/settings.json",

"%LOCALAPPDATA%/transmission-daemon/settings.json",

]

match = { key_path = ["rpc-password"] }

# The three directory settings are absolute paths into one machine's disk —

# "/home/dev/Downloads", "D:\\Torrents" — and pointing another machine's

# Transmission at a directory that does not exist there is how downloads end up

# failing on start. They are worth keeping rather than discarding, so that the

# device they belong to can be restored: scope = backup.

[[machine_lines]]

file = [

"~/.config/transmission/settings.json",

"~/.config/transmission-daemon/settings.json",

"%LOCALAPPDATA%/transmission/settings.json",

"%LOCALAPPDATA%/transmission-daemon/settings.json",

]

match = { key_path = ["download-dir", "incomplete-dir", "watch-dir"] }

scope = "backup"

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/transmission. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page. None of them splits download-dir and incomplete-dir for you — that part is Otty’s own sync, or a template you write by hand.