Skip to main content

​
Installation Methods

You can install the Kaleidoswap Desktop App in two ways:

​
1. Download Binaries

  1. Download: Visit the Releases page and download the appropriate binary for your operating system.
  2. Verify: Download the manifest.txt and manifest.txt.sig files to verify the authenticity of your download. See our Binary Verification Guide for detailed instructions.
  3. Install: Run the app by executing the binary.

​
2. Building Locally

​
Common Prerequisites

  • Tauri 1.6.0
    Make sure you have installed all the official Tauri prerequisites (Rust, Node.js, npm, 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 on Windows
  • Consider using a Docker container for RLN and connect remotely
  • 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, pkg-config, and SSL libraries
  • Install GTK and WebKit requirements (libsoup 2.4, javascriptcoregtk 4.0, webkit2gtk 4.0)
  • Confirm correct installation of Rust, Node.js, npm, and pnpm

​
Building and Running

  1. Install dependencies: 
    npm install
  2. Build the Tauri app: 
    tauri build
  3. Run Kaleidoswap in development mode: 
    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: 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.