Skip to content

Usage Configuration

Alex edited this page Oct 2, 2026 · 2 revisions

Configuration

Part of the Usage reference. · ← Previous: Inventory, wallet & market · Next: Proton & Wine runtimes →

config show

Print the current launcher configuration as JSON (library path, default Proton version, cloud-sync setting, per-game overrides, …).

aurelia config show

config protons

List detected Proton/Wine runtimes, both Steam-managed runtimes and custom ones under compatibilitytools.d. (See also proton list, which adds runtimes available to download.)

aurelia config protons

config presence

View or set the Steam presence the session daemon announces so it can sync your friends list and receive chat (see Friends & chat). Run with no argument to print the current value.

aurelia config presence [online|offline] [--json]
Value Meaning
offline (default) An invisible presence: you appear offline to friends, but the daemon still receives your friends list and incoming messages.
online You appear online to friends while the daemon is running.

The setting is read when the daemon establishes its session, so after changing it restart the daemon for it to take effect (aurelia daemon stop, or aurelia kill). The --json output is { "chat_presence": "online"|"offline" }.

aurelia config presence                 # print the current presence
aurelia config presence online          # appear online to friends
aurelia config presence offline --json  # back to invisible; {"chat_presence":"offline"}

config language

View or set the default Steam API language name used for store text and achievement names (info, achievements and the store commands) when their --lang flag is not given. Run with no argument to print the current value. Pass an empty string to clear it. config lang is an alias.

While it is unset, Aurelia uses the system locale (e.g. de_DE.UTF-8 → german, pt_BR → brazilian, es_MX → latam, zh_TW → tchinese), and English when the locale is unset, C or POSIX.

aurelia config language [<NAME>] [--json]
aurelia config language            # print the current default
aurelia config language german     # set German as the default
aurelia config language ""         # clear it (back to the system locale, else english)

The --json output is { "language": "german"|null }.

config country

View or set the default price country, a two-letter ISO code used by info, dlc, wishlist and the store commands when their --country flag is not given. Run with no argument to print the current value. Pass an empty string to clear it. config cc is an alias. Added in v0.1.37-2.

While it is unset, Aurelia uses the region of the system locale, and US when the locale has none. An invalid code is rejected with "type": "invalid_input".

aurelia config country [<CC>] [--json]
aurelia config country             # "Country: DE", or "Country: auto (system locale, else US)"
aurelia config country DE          # quote prices for Germany by default
aurelia config country ""          # clear it (back to the system locale, else US)

The --json output is { "country": "DE"|null }.

config game

View or set a game's per-game launch settings: the Proton/Wine version it runs with and its platform target. Run with no flags to print the current settings.

aurelia config game <APP_ID> [-p <VERSION>] [-P] [-t <windows|linux>] [-T] [--json]
Option Description
-p, --proton <VERSION> Pin the Proton/Wine version for this game (a name from proton list). Overrides the global default at launch.
-P, --clear-proton Remove the per-game version, so the game falls back to the global default.
-t, --platform <windows|linux> Force the platform target. windows runs through Proton/Wine on Linux.
-T, --no-platform Clear the platform preference (back to auto-detection).
-n, --native-engine Route this game through the luxtorpeda native-engine plugin (Linux only, requires aurelia luxtorpeda enable).
-N, --no-native-engine Clear luxtorpeda routing, back to normal native/Proton selection.
-u, --umu Route this game through the umu-launcher plugin (Proton via umu, Linux only, requires aurelia umu enable).
-U, --no-umu Clear umu routing, back to normal native/Proton selection.
-s, --launch-script <PATH> / -S, --no-launch-script Set or clear the per-game launch script.
-r, --steam-runtime <auto|on|off> / -m, --steam-prefix-mode <shared|per-game> Per-game Windows Steam runtime settings.
--clear Reset all of this game's per-game settings to defaults.

aurelia config clear-games [-y] resets the per-game settings of every game (-y, --yes skips the confirmation).

At launch, the Proton version is resolved in this order: an explicit play --proton flag → this per-game version → the global default (only when the game targets Windows). The --json output is { "app_id", "forced_proton_version", "platform_preference", "runner" }.

aurelia config game 1245620                          # show current settings
aurelia config game 1245620 --proton GE-Proton9-20   # pin a Proton version
aurelia config game 1245620 --clear-proton           # back to the global default
aurelia config game 1245620 --platform windows

Clone this wiki locally