Skip to content

Quick start

Rezeptor installs and launches Windows software on Linux with tested recipes and Proton-GE.

Requirements

  • Linux (x86_64), desktop environment
  • Network on first run (Proton-GE download per core/runtime.lock)

Depends on how you install:

Path Host PyQt6 needed?
Git clone or tar.gz + ./setup.sh Yes — distro package python-pyqt6 (Arch/CachyOS) or equivalent; optional PyQt6-Fluent-Widgets
AppImage (release) No — Python and PyQt6 are bundled (recommended on Bazzite / immutable distros). Qt still needs basic X11 libs on the host; current AppImages also ship libxcb-cursor for the xcb platform plugin.
Flatpak (release) No — Python, PyQt6, and Proton-GE are bundled

If an older AppImage fails with libxcb-cursor.so.0: cannot open shared object file, install the package for your distro (or update to a newer Rezeptor AppImage):

# Debian / Ubuntu / Mint
sudo apt install libxcb-cursor0
# Arch / CachyOS / Manjaro
sudo pacman -S libxcb-cursor
# Fedora / RHEL
sudo dnf install libxcb-cursor
# openSUSE
sudo zypper install libxcb-cursor0

The launcher System check dialog can install missing host tools (curl, unzip, …) and libxcb-cursor via pkexec when the GUI already starts.

Installation

From the repository (host PyQt6 required)

git clone https://github.com/benjarogit/rezeptor.git
cd rezeptor
./setup.sh

AppImage (no host PyQt6)

  1. Download rezeptor-*-x86_64.AppImage and SHA256SUMS from GitHub Releases
  2. Verify: sha256sum -c SHA256SUMS
  3. chmod +x rezeptor-*-x86_64.AppImage && ./rezeptor-*-x86_64.AppImage

Flatpak (no host PyQt6)

flatpak install --user rezeptor-<version>-x86_64.flatpak
flatpak run io.github.benjarogit.Rezeptor

Build locally: scripts/build-flatpak.sh (needs flatpak-builder and runtime org.freedesktop.Platform//25.08).

tar.gz release (host PyQt6 required)

  1. Download rezeptor-*.tar.gz and verify with sha256sum -c SHA256SUMS
  2. Unpack and run ./setup.sh

First steps in the GUI

  1. Pick a recipe in the sidebar
  2. Set the source (installer, portable folder, EXE — depends on the recipe; BYOS)
  3. For portable recipes, set a target if needed
  4. Install — watch progress in the activity log
  5. Check status (optional on startup; anytime with F5)
  6. Launch

Where is the data?

Path Contents
~/.local/share/wine-software/<id>/ Recipe state, prefix (prefix/), recipe.env
~/.local/share/wine-software/runtime/proton-ge/ Shared Proton-GE (survives uninstall)
~/.local/share/wine-software/logs/ Install/validate logs
~/.local/share/wine-software/rezeptor/settings.json Launcher settings
Portable / game folders Often outside (e.g. ~/Documents/…, Steam library)

Developer mode

REZEPTOR_DEV=1 ./setup.sh

Or enable Developer mode in Settings (edit recipe files in the GUI).

Further reading