Getting Started
Installation
How to install zlaunch on your system
Nix / NixOS
zlaunch provides a Nix flake for easy installation.
Try it out
nix shell github:zortax/zlaunch/0.4.0Flake installation
Add zlaunch to your flake inputs:
{
inputs = {
nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
zlaunch.url = "github:zortax/zlaunch/0.4.0";
};
outputs = { nixpkgs, zlaunch, ... }: {
# Use zlaunch.packages.${system}.default
};
}NixOS configuration:
{ inputs, pkgs, ... }:
{
environment.systemPackages = [
inputs.zlaunch.packages.${pkgs.system}.default
];
}home-manager:
{ inputs, pkgs, ... }:
{
home.packages = [
inputs.zlaunch.packages.${pkgs.system}.default
];
}Arch Linux (AUR)
Pre-compiled binary (recommended)
paru -S zlaunch-binBuild from source
paru -S zlaunch-gitReplace paru with your preferred AUR helper (yay, aura, etc.)
Pre-built Binary
Download pre-built binaries from GitHub Releases.
Available Architectures
| Architecture | Artifact |
|---|---|
| x86_64 | zlaunch-<version>-x86_64-linux.tar.gz |
| aarch64 | zlaunch-<version>-aarch64-linux.tar.gz |
Installation
# Download (replace VERSION and ARCH)
curl -LO https://github.com/zortax/zlaunch/releases/download/VERSION/zlaunch-VERSION-ARCH-linux.tar.gz
# Extract
tar -xzf zlaunch-VERSION-ARCH-linux.tar.gz
# Install
sudo cp zlaunch-VERSION-ARCH-linux/zlaunch /usr/local/bin/Runtime Dependencies
The binary requires these libraries at runtime:
- wayland
- freetype
- fontconfig
- openssl
- libxkbcommon
- vulkan (ICD loader)
glibc Compatibility
The pre-built binaries are compiled on Ubuntu 24.04 and require glibc 2.39 or newer. This means they work on:
- Ubuntu 24.04+
- Fedora 40+
- Arch Linux (rolling)
- Debian 13 (trixie)+
Older distributions (Ubuntu 22.04, Debian 12, etc.) should build from source instead.
Building from Source
Prerequisites
- Rust (stable, edition 2024)
- System dependencies:
- wayland, libxkbcommon
- freetype, fontconfig
- openssl
- vulkan-loader
- pkg-config
Arch Linux:
sudo pacman -S wayland libxkbcommon freetype2 fontconfig openssl vulkan-icd-loader pkgconfBuild
git clone https://github.com/zortax/zlaunch.git
cd zlaunch
cargo build --releaseThe binary will be at ./target/release/zlaunch.
Install
sudo cp ./target/release/zlaunch /usr/local/bin/Verify Installation
zlaunch --version