Desktop App Settings

The Settings panel is accessible from the drop-down menu in the upper right corner of the app. It is organized into Application Settings, Maker & LSP Settings, and Node Connection Settings, with Security & Backup and Node Status panels alongside. Most changes take effect after clicking Save; changes under Node Connection Settings additionally require a node restart.

​

Application Settings

​

Capabilities (App Mode)

What it does: Chooses which parts of KaleidoSwap are shown:

• Node + Mind — run the wallet/node and the local AI brain (KaleidoMind) together
• Only Node — just the RGB Lightning node, channels and swaps
• Only Mind — just the local AI brain, no node required

​

Bitcoin Unit

What it does: Controls how Bitcoin amounts are displayed throughout the app.

• Satoshi (SAT) — displays amounts as satoshis, the smallest unit (e.g., 100,000 sats)
• Bitcoin (BTC) — displays amounts as decimal Bitcoin (e.g., 0.001 BTC)

When to change it: If you find decimal amounts hard to read for small transactions, switching to sats can reduce confusion and eliminate leading zeros.

​

Fiat Currency

What it does: Sets the fiat currency used to display the estimated value of your balances and swaps.

​

Language

What it does: Sets the display language of the app. Several languages are available in the dropdown.

​

Theme

Dark mode is the only supported theme. Light mode was disabled to avoid inconsistent rendering across screens, so Settings has no theme switch and the app ignores your operating system’s preference.

​

Maker & LSP Settings

​

Maker URLs

What it does: Manages the list of market maker endpoints the app can connect to for quotes and swaps. You can add multiple makers, remove them, and mark one as the default (star icon).

​

LSP URL

What it does: Sets the URL of the Lightning Service Provider your node connects to for channel liquidity and swap routing. This usually matches your default Maker URL. When to change it: The default is pre-configured and works for most users. You may want to change it if you run your own LSP, your preferred LSP has a different URL, or the default is unreachable.

​

Node Connection Settings

​

Node Connection String

What it does: Specifies the RGB Lightning Node (RLN) that the app connects to for all wallet, channel, and payment operations (e.g. http://localhost:3001). When to change it: By default the app manages a built-in local node. Change this if you are connecting to a remote or self-hosted RGB Lightning Node, or switching between node instances.

​

Bitcoin RPC

What it does: The Bitcoin Core RPC connection string the node uses to reach its bitcoind backend.

​

Indexer URL

What it does: The Electrum/Esplora indexer the node uses to query the blockchain.

​

RGB Proxy Endpoint

What it does: The RGB proxy endpoint used for exchanging RGB transfer data.

​

Security & Backup

The Security & Backup panel provides:

• View Recovery Phrase — reveal your wallet’s mnemonic seed phrase
• Change Password — update the wallet encryption password
• Backup — create an encrypted backup of your channel state. See the Channel Backups page for full instructions.

​

Node Status

Shows whether the node is running or offline and whether it is a local or remote node. From here you can Logout (locks the node) or Shutdown the node. For local nodes, live node logs are also shown at the bottom of the Settings page.

---