// OPENBOX DOCS
Faugus Launcher Integration
Import Faugus Launcher games and their prefixes, with suggested UMU launch commands.
OpenBox provides native integration with Faugus Launcher, the lightweight Linux game manager for Wine and UMU games: it reads Faugus manifests and prefixes and imports the titles into your unified library.
Overview
Faugus Launcher is a Linux launcher, so this integration is Linux only. On Windows and macOS the scanner finds nothing and its controls are hidden.
When Faugus Launcher is installed, OpenBox can scan its data directories, read each game's prefix configuration, and import the titles into your unified library. OpenBox looks for Faugus data in ~/.config/faugus-launcher, ~/.local/share/faugus-launcher, ~/Faugus, the matching XDG_CONFIG_HOME/XDG_DATA_HOME locations, and prefix directories containing drive_c.
How to Import from Faugus
- Open Add games in the top bar and choose Guided setup… (the Setup Center, headed "Set up your library").
- On the Sources step, add the Faugus source.
- Continue to the scan: OpenBox detects all titles defined in Faugus manifests and prefix directories as preview candidates.
- Review and commit the preview as usual.
You can also drive the scan entirely through the REST API (below).
Each imported title automatically receives:
- Cross-source identity deduplication (a title already in the library from another source is merged rather than added twice)
- Target executable path
- Dedicated Wine prefix path, recorded as
wine_prefix - A suggested launch command (
umu-run {path}) — a starting point you can edit in Edit Metadata, not a wrapper the app applies for you. Prefix-only rows import without it.
REST Endpoints
Automate Faugus scans or integrate with scripts:
GET /api/v2/faugus/status: Reports whether Faugus data directories exist, and which ones.GET /api/v2/faugus/scan: Scans manifests and prefix directories and returns the discovered games with their prefix and runner metadata.POST /api/v2/faugus/import: Imports the scanned games into the OpenBox library.
# Check Faugus installation status
curl -s -H "X-OpenBox-Token: $TOKEN" http://127.0.0.1:$PORT/api/v2/faugus/status
# Scan for installed titles
curl -s -H "X-OpenBox-Token: $TOKEN" http://127.0.0.1:$PORT/api/v2/faugus/scan