otty / dotfiles

All tools/Electrum

Electrum

electrum

Lightweight Bitcoin client.

Detected by electrum | macOS, Linux, Windows |electrum.org

Sync it electrum.toml

Sync rules

What travels, what stays, what never leaves

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

{

"auto_connect": true,

"backup_dir": "/Users/octocat/Documents/Electrum Backups",machine-local

"check_updates": false,

"config_version": 3,

"decimal_point": 8,

"dont_show_testnet_warning": false,

"fee_level": 2,

"io_dir": "/Users/octocat/Downloads",machine-local

"language": "en_UK",

"recently_open": [

"/Users/octocat/.electrum/wallets/default_wallet",

…

Each machine keeps its own copy of these.

…

"fee_level": 2,

"io_dir": "/Users/octocat/Downloads",

"language": "en_UK",

"recently_open": [machine-local

"/Users/octocat/.electrum/wallets/default_wallet",

"/Users/octocat/.electrum/wallets/savings"

],

"rpcpassword": "FAKE0000rpcpassword0000",

"rpcport": 7777,

"rpcsockpath": "/Users/octocat/.electrum/daemon_rpc_socket",machine-local

"rpcuser": "user-FAKE0000",

"server": "electrum.example.com:50002:s",

"use_rbf": true

…

Each machine keeps its own copy of these.

rpcuserrpcpassword

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

· wallets/ Never synced

{

"auto_connect": true,

"backup_dir": "C:/Users/octocat/Documents/Electrum Backups",machine-local

"check_updates": false,

"config_version": 3,

"decimal_point": 8,

"fee_level": 2,

"io_dir": "C:/Users/octocat/Downloads",machine-local

"language": "en_UK",

"recently_open": [

"C:/Users/octocat/AppData/Roaming/Electrum/wallets/default_wallet"

…

Each machine keeps its own copy of these.

…

"fee_level": 2,

"io_dir": "C:/Users/octocat/Downloads",

"language": "en_UK",

"recently_open": [machine-local

"C:/Users/octocat/AppData/Roaming/Electrum/wallets/default_wallet"

],

"rpcpassword": "FAKE0000rpcpassword0000",

"rpcport": 7777,

"rpcsockpath": "C:/Users/octocat/AppData/Roaming/Electrum/daemon_rpc_socket",machine-local

"rpcuser": "user-FAKE0000",

"server": "electrum.example.com:50002:s",

"use_rbf": true

…

Each machine keeps its own copy of these.

rpcuserrpcpassword

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

· wallets/ Never synced

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

apps/electrum.tomlThe file this page is generated from

id = "electrum"

name = "Electrum"

homepage = "https://electrum.org"

description = "Lightweight Bitcoin client."

# The project's own icon, the apple-touch-icon on its homepage.

icon = "https://electrum.org/apple-touch-icon.png"

detect = ["electrum"]

# https://electrum.readthedocs.io/en/latest/faq.html ("Where is my wallet file

# located?" / "Where is the datadir?"): the data directory is ~/.electrum on

# both Linux and macOS — Electrum does not use ~/Library/Application Support —

# and %APPDATA%\Electrum on Windows. It holds "wallet files, config settings,

# logs, blockchain headers, etc.", with wallets in a wallets/ subfolder.

# electrum/simple_config.py: `path = os.path.join(self.path, "config")` and

# `json.loads(data)` — the settings file is named `config` with no extension

# and is JSON. Only that file is named here; the headers, logs and forks/

# beside it are downloaded chain state, not configuration.

paths = [

"~/.electrum/config",

"%APPDATA%/Electrum/config",

]

exclude = []

# The wallet files. Electrum's FAQ: "Your wallet can be entirely recovered

# from its seed", and the seed and private keys live inside the wallet file

# (encrypted with a password the user may or may not have set). A wallet file

# is a key, not a setting, so it never syncs as plaintext content.

secret = [

"~/.electrum/wallets/",

"%APPDATA%/Electrum/wallets/",

]

# The JSON-RPC credentials Electrum writes into the config file:

# simple_config.py declares RPC_USERNAME = ConfigVar('rpcuser') and

# RPC_PASSWORD = ConfigVar('rpcpassword'). Both spellings of the file, or the

# password is only lifted out on Unix and syncs in the clear from Windows.

# `config` has no extension, so format has to be stated.

[[secret_paths]]

file = ["~/.electrum/config", "%APPDATA%/Electrum/config"]

format = "json"

match = { key_path = ["rpcuser", "rpcpassword"] }

# All four keys in the two rules below are absolute paths on one machine.

# Currency, fee policy, language and GUI preferences are deliberately not

# here — those are what a user wants carried over.

# `backup_dir` is where wallet backups are written and `io_dir` (ConfigVar

# default os.path.expanduser('~')) is where the import/export dialogs start:

# two directories the user picked in the GUI, and the first thing they would

# want to see again when putting this machine back together — backup.

[[machine_lines]]

file = ["~/.electrum/config", "%APPDATA%/Electrum/config"]

format = "json"

match = { key_path = ["backup_dir", "io_dir"] }

scope = "backup"

# Split out of the rule above because these two are not the user's choice at

# all: `recently_open` is the MRU list Electrum rewrites every time a wallet is

# opened, and `rpcsockpath` is the daemon's socket, derived from the data

# directory. Neither is worth keeping, so both stay local.

[[machine_lines]]

file = ["~/.electrum/config", "%APPDATA%/Electrum/config"]

format = "json"

match = { key_path = ["recently_open", "rpcsockpath"] }

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/electrum. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps all credential files out. None of them splits backup_dir and io_dir for you — that part is Otty’s own sync, or a template you write by hand.