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 Native Binary node backend is not available on Windows. To run a local node on Windows, choose Local Node → Docker Container in the app (requires Docker Desktop to be running), or connect to a remote node — 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.

The app runs the node either as a Native Binary (macOS/Linux) or in a Docker Container (all platforms; the app pulls and manages the container). 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.

---