Getting Started

Installation

Everything you need to set up Swipe on your Linux machine.

Prerequisites

Before installing Swipe, ensure your system meets these requirements:

  • Linux kernel 4.4+ (5.4+ recommended for full NVMe support)
  • Root / sudo privileges (required for direct disk access)
  • libgtk-3-0, liblzma5, libblkid1
  • smartmontools (for SMART health monitoring)
  • At least 256MB free RAM

Install Pre-Built Binary (Recommended)

Download the pre-compiled build for your distribution from our Download Center, then:

Terminal 
# Extract the archive
tar -xzf swipe-linux-ubuntu.tar.gz
cd swipe-linux-ubuntu

# Install system-wide
sudo ./install.sh

# Verify installation
sudo swipe

Root Privileges Required

Swipe must run as root (sudo) to access raw disk devices. The install script copies files to /opt/swipe and creates a desktop menu entry.

Build from Source

For developers or if pre-built binaries are not available for your distribution.

1. Build Dependencies

# Ubuntu / Debian
sudo apt-get install -y cmake build-essential libudev-dev libssl-dev \
  clang ninja-build pkg-config libgtk-3-dev liblzma-dev smartmontools

# Install Flutter SDK
# See https://docs.flutter.dev/get-started/install/linux

2. Build Backend (C Library)

cd swipe-cli
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
# Output: build/libdriveinfo.so

3. Build Frontend (Flutter App)

# Copy library to Flutter project
cp swipe-cli/build/libdriveinfo.so swip2.0/linux/libs/

cd swip2.0
flutter pub get
flutter build linux --release
# Output: build/linux/x64/release/bundle/swipe

4. Install

sudo mkdir -p /opt/swipe
sudo cp -r build/linux/x64/release/bundle/* /opt/swipe/
sudo chmod +x /opt/swipe/swipe
sudo ln -sf /opt/swipe/swipe /usr/local/bin/swipe

Pro Tip

The GitHub Actions pipeline (build-deploy.yml) automates all these steps. Every push to main triggers a fresh build.