KaleidoSwap Desktop App: Installation

​

Installation Methods

You can install the KaleidoSwap Desktop App in two ways:

​

1. Download Binaries

1. Download: Get the latest build from the KaleidoSwap downloads page or the GitHub Releases page, choosing the appropriate binary for your operating system.
2. Verify: Check your download against the GPG-signed SHA256 checksum manifest before installing. See our Binary Verification Guide for detailed instructions.
3. Install: Run the app by executing the binary.

​

2. Building Locally

​

Common Prerequisites

• Tauri 2.x
  Make sure you have installed all the official Tauri prerequisites (Rust, Node.js, pnpm).
• Repository
  git clone https://github.com/kaleidoswap/desktop-app
  cd desktop-app
  

​

Platform-Specific Instructions

Windows:

• The RGB Lightning Node integration is not yet fully supported natively on Windows. To get started with RLN on Windows, run it in a Docker container and connect remotely — see Node Hosting, or Troubleshooting for other remote-node options
• Install vcpkg to install libraries like openssl and sqlite3
• Ensure Microsoft Visual C++ is installed (via Visual Studio or Build Tools)

Linux:

• Install build-essential and pkg-config
• Install the WebKitGTK / GTK dependencies used by the CI build: libwebkit2gtk-4.1-dev, libwebkit2gtk-4.0-dev, libgtk-3-dev, libglib2.0-dev, librsvg2-dev, libappindicator3-dev, and patchelf
• Confirm correct installation of Rust, Node.js, and pnpm

​

Building and Running

1. Install dependencies:
   pnpm install
   
2. Build the Tauri app:
   pnpm tauri build
   
3. Run KaleidoSwap in development mode:
   pnpm tauri dev
   

​

Node Setup Options

After installing KaleidoSwap, you’ll need to connect to an RGB Lightning Node. You have two options:

​

Option 1: Connect to a Remote Node

If you prefer not to run a node on your local machine, you can connect to a remote RGB Lightning Node:

• Self-hosted remote node: Learn how to set up your own RGB Lightning Node on a VPS or server by following our RGB Lightning Node Hosting guide.
• Hosted provider: Connect to a professionally managed node from a service provider like ThunderStack.

Advantages of remote nodes:

• No local resources required
• 24/7 availability (for hosted solutions)
• Simplified setup process

​

Option 2: Create a Local Wallet with Integrated Node

For complete control and privacy, you can run a node directly on your machine:

• Follow the Creating a New Wallet guide to set up a local wallet with an integrated RGB Lightning Node.

Advantages of local nodes:

• Full control over your node
• Enhanced privacy
• No dependency on external services

Choose the option that best fits your technical skills and requirements before proceeding with the KaleidoSwap setup.

---