Configuration & files¶
Everything Laufzeit stores, the command-line options it understands, and what a game launch sets up.
Laufzeit's app ID is com.tristan.laufzeit, so its folders follow the XDG base directories under that
name.
- Configuration file
- Data
- Elsewhere on your system
- Command-line options
- API keys
- What a launch sets up
- Backing up and resetting
Configuration file¶
~/.config/com.tristan.laufzeit/config.json holds the library and all settings: the games, the prefix
list, the global Performance, Graphics, Overlay and Proton settings, the SteamGridDB API key, the
GitHub token, under library your categories, favorites, hidden games and play times, and under
backup the automatic backups' settings.
Laufzeit saves it atomically (written to a temporary file, then renamed), so a crash or a full disk never leaves half a file. If the file can't be read when Laufzeit starts, Laufzeit shows the error and quits without touching it, rather than starting empty and overwriting your library on the next save. Fix the JSON or move the file away to start fresh.
Several Laufzeit processes can use the file at once: the window, the command line, and the one Steam
starts for a game. A command line call that changes the library holds config.json.lock while it
runs. Anything that takes long (a store install or uninstall, a game's first launch with its
prerequisites, recording play time, a restore) writes its result into the file as it is on disk
by then, under that lock, so changes made meanwhile in the window or by another command stay.
The runners folder is the one setting without a UI: runners_dir in config.json. Quit Laufzeit
before editing the file.
Data¶
~/.local/share/com.tristan.laufzeit/ holds everything Laufzeit downloads or generates:
| Path | Contents |
|---|---|
runners/ |
Downloaded runners, one folder each. Any Proton or Wine build you put or symlink here is listed too. |
umu-launcher/ |
Laufzeit's own copy of umu-launcher, with its version. |
directx-layers/ |
DXVK and VKD3D-Proton for Wine runners, with their versions, and the cached wine-mono installers. |
winetricks/ |
The winetricks script, refreshed weekly. |
artwork/ |
Images chosen from SteamGridDB, named after the game's ID, and the covers of store games (store-epic-<app>.jpg, store-gog-<id>.jpg, store-amazon-<id>.jpg). |
helpers/ |
The store tools (Legendary, gogdl, Nile), one file per pinned version. Removed when you disconnect the store. |
stores/<store>/install.lock |
Held while one of the store's games installs, so the window and the command line never install from the same store at once. |
stores/epic/ |
Legendary's own config (legendary/, including your Epic login) and the cached game list (library.json). |
stores/gog/ |
gogdl's login and manifests (gogdl/), your account name (account.json), the cached game list (library.json) and GOG's shared redistributables (redist/). |
stores/amazon/ |
Nile's config (nile-config/nile/: your Amazon login, the game list, the installed games and their manifests, the Amazon Games SDK) and the cached game list (library.json). |
prefixes/ |
The prefixes created for store games, one per game (epic-<app>, gog-<id>, amazon-<id>). |
exe-icons/ |
Icons extracted from the games' .exe files. |
backups/ |
The automatic backups, when turned on under Backup, and the one made before every restore. Another folder can be picked there. |
mangohud/, vkbasalt/ |
The MangoHud and vkBasalt config of each game, written on every launch. |
logs/<game-id>/ |
The last 10 launch logs of each game. |
logs/prefixes/<prefix>/ |
The last 10 logs of setup programs, winetricks and Wine tools run in a prefix. |
logs/stores/<store>/<app>/ |
The last 10 install logs of each store game. |
shortcut-icons/ |
The icon of the Install Laufzeit file-manager entry. |
WebKitCache/, storage/, localstorage/ |
The window's own browser data (see Troubleshooting). |
~/.cache/com.tristan.laufzeit/umu-database.json caches the umu database for the protonfixes search
and the library's umu fix badges for a day, and protondb.json the games' ProtonDB ratings for a
week.
Your prefixes live wherever you created or found them; Laufzeit only remembers their paths.
Elsewhere on your system¶
| Path | Written when |
|---|---|
~/.local/share/umu/ |
umu-launcher downloads the Steam Linux Runtime there, shared with other umu-based launchers. Follows UMU_FOLDERS_PATH and XDG_DATA_HOME as umu does. |
~/.local/share/applications/com.tristan.laufzeit.install.desktop |
On every start, to register Install Laufzeit in your file manager's Open With menu for .exe files. Hidden from the app menu. |
~/.local/share/applications/<game>-<id>.desktop |
To start menu on a game. |
| Your desktop folder | To desktop on a game. Laufzeit honors a localized XDG_DESKTOP_DIR, such as ~/Schreibtisch. |
~/.steam/root/userdata/<user>/config/shortcuts.vdf and grid/ |
Add to Steam, Update in Steam and Remove from Steam. The previous file is kept as shortcuts.vdf.bak. |
$XDG_RUNTIME_DIR/laufzeit/<game-id>.lock |
While a game launches or runs, so two Laufzeit processes (an open window and one Steam started) never start the same game twice. |
~/.claude/skills/laufzeit/SKILL.md |
Only when you run laufzeit skill install: the Laufzeit skill for Claude Code. |
/etc/sysctl.d/99-laufzeit-max-map-count.conf |
Only when you click Increase now for vm.max_map_count, after a password prompt. |
Coming from Prefixr¶
Laufzeit was called Prefixr until version 0.2. The first start under the new name, from the window, a shortcut, Steam or the command line, carries everything over:
~/.config/com.tristan.prefixr/,~/.local/share/com.tristan.prefixr/and~/.cache/com.tristan.prefixr/move to thecom.tristan.laufzeitfolders, and the paths inconfig.jsonthat pointed into them are changed to match. A folder that already exists under the new name is left alone.~/.local/share/com.tristan.prefixrstays behind as a symlink to the new folder, so whatever else points into it (a prefix's own files, the store tools' install lists) keeps working.- Desktop and start menu shortcuts and Steam entries that start a game through Prefixr are rewritten to start it through Laufzeit. Steam's are rewritten only while Steam is closed (in the Flatpak always), so start Laufzeit once with Steam closed. Install Prefixr leaves the file manager's Open With menu.
- An installed Prefixr skill (
~/.claude/skills/prefixr) is replaced by the Laufzeit skill. - A backup Prefixr made restores as one of Laufzeit's.
- The
.deband.rpmpackages replace theprefixrpackage. - The Flatpak's app ID is now
io.github.firsttris.Laufzeit. Its.desktopfile names the old one inX-Flatpak-RenamedFrom, so Flatpak moves~/.var/app/io.github.firsttris.Prefixrover on the first start. Uninstall the old Flatpak afterwards withflatpak uninstall io.github.firsttris.Prefixr. Should the library still come up empty, make a backup in the old Flatpak and restore it in Laufzeit (see Backing up and resetting).
Command-line options¶
| Option | Effect |
|---|---|
laufzeit --launch <game-id> |
Starts the game. If Laufzeit is already open, that window starts it instead. Desktop and menu shortcuts use this. |
laufzeit --run <game-id> |
Starts the game without any window and exits when the game does. A failure before the game starts is shown in a dialog. Steam uses this for games added to it. |
laufzeit --install <path/to/setup.exe> |
Opens the install dialog for that setup program. The Install Laufzeit file-manager entry uses this. |
laufzeit game …, library …, category …, store …, prefix …, runner …, umu …, backup …, skill … |
The command line: everything the window does, from a terminal or a script. See Command line & AI agents. |
A game's ID is the id of its entry in config.json. It also appears in the Exec= line of the
game's shortcuts.
API keys¶
Both are optional and stored in config.json.
| Key | Where to enter it | What it's for |
|---|---|---|
| SteamGridDB API key | SteamGridDB page | Searching artwork, and finding a game's Steam app ID for the protonfixes match |
| GitHub personal access token, no scopes | Runners page, GitHub section | Raising GitHub's API limit from 60 to 5000 requests per hour for runner, umu and DXVK downloads |
What a launch sets up¶
For reference when reading a game's log or reproducing a launch by hand.
The command, from the outside in, each part only when it's enabled and available:
gamescope [-w W] [-h H] [-r FPS] [-f] [--mangoapp] --systemd-inhibit --what=idle:sleep --, for Prevent sleeppowerprofilesctl launch --profile performance, for the performance power profileumu-runfor a Proton runner, or the runner'swinefor a Wine runner- the game's
.exeand its launch arguments
The environment:
| Variable | Set to |
|---|---|
WINEPREFIX |
The game's prefix |
WINEDLLOVERRIDES |
Always winemenubuilder.exe=, so Wine doesn't add menu entries and file associations for what runs in the prefix. For a Wine runner also the DXVK and VKD3D-Proton DLLs as native-then-builtin. |
PROTONPATH |
The Proton runner (Proton only) |
GAMEID, STORE |
The game's protonfixes match (Proton only) |
PROTON_* |
The Proton switches set to On (1) or Off (0) |
WINEDEBUG |
-all for a Wine runner, which keeps Wine's debug output from slowing games down |
MANGOHUD, MANGOHUD_CONFIGFILE |
With the overlay enabled |
ENABLE_VKBASALT, VKBASALT_CONFIG_FILE |
With vkBasalt enabled |
LD_PRELOAD |
libgamemodeauto.so.0 with GameMode. An LD_PRELOAD Laufzeit itself was started with (such as Steam's overlay) is kept. |
With Gamescope, the MangoHud and vkBasalt variables only go to the game inside it, so they don't apply to Gamescope's own output a second time.
The game's own environment variables come last and win, except WINEDLLOVERRIDES and LD_PRELOAD,
which are appended to.
Before a Proton game's first launch, Laufzeit creates the prefix with umu's createprefix so the
download of the Steam Runtime shows as Starting…. Before a Wine game's first launch, it runs
wineboot, installs the wine-mono version that Wine build expects, and links in DXVK and
VKD3D-Proton.
Backing up and resetting¶
- To back up your library, use Backup in the sidebar or
laufzeit backup create(see Backup and restore): one file withconfig.json, the artwork and the exe icons. Copying~/.config/com.tristan.laufzeit/config.jsonand~/.local/share/com.tristan.laufzeit/artwork/by hand works too. Save games live in the prefixes, so back those up separately. - Automatic backups are off until you turn them on under Backup. They go to
~/.local/share/com.tristan.laufzeit/backups/unless you pick another folder there: one every few days (daily by default), and one before every restore; the newest 7 are kept unless you set another number. - To start over, quit Laufzeit and remove
~/.config/com.tristan.laufzeit/. To free the space runners and caches take, also remove~/.local/share/com.tristan.laufzeit/. Neither touches your prefixes or games.