A terminal UI for browsing, installing, updating, and launching your Steam
library — powered by the aurelia
command-line Steam launcher.
Aurelia TUI is a graphical front-end for the aurelia CLI. It is a rebuild of
steam-tui: where the original drove
steamcmd directly, Aurelia TUI shells out to the modern aurelia binary
(using its --json output for every backend operation) and lets it handle the
heavy lifting — authentication, library listing, downloads, and launching
(including Proton/Wine on Linux).
Note
Steam no longer offers a backend-only mode, so a CLI-driven client like this is necessarily limited — but it stays useful if you'd rather not run the full Steam client.
- The
aureliaCLI, version>= 0.1.40(on Arch: theaureliaAUR package; otherwise build it from source). - A Steam account (logging in is described below).
Aurelia TUI looks for the aurelia binary in this order:
- The
AURELIA_BINenvironment variable, if set (point it at a specific build). - A sibling
Aureliacheckout next to this project (../Aurelia/target/release/or.../debug/) — handy when developing both. aureliaon yourPATH.
If none of these resolve, the sign-in screen tells you the binary couldn't be
found. The detected aurelia version is shown in the bottom-right corner of the
library footer, in the warning colour if it is older than 0.1.40 or missing.
It's a standard Rust project:
cargo build --release
./target/release/aurelia-tuiLaunch aurelia-tui and you're off — the in-app help bar always shows the keys
for the current screen.
On startup it checks your session with aurelia login --health --json (which
reflects either a stored session or a running aurelia daemon). If you're
already signed in, it goes straight to your library.
If no session is found, you get a sign-in screen with two options:
Enter— username & password, entered inside the TUI. If Steam Guard asks for a code, you type it on the next screen. The password is handed toaureliathrough theAURELIA_PASSWORDenvironment variable so it never appears in the process list — but it is still typed into the TUI, so use QR if you'd rather it never be entered here at all.y— QR code, scanned with the Steam Mobile app. Nothing secret is typed anywhere; it shells out toaurelia login --qr.
Either path loads your library automatically once you authenticate. You can also
log in out-of-band with aurelia login in a terminal, then press r on the
sign-in screen to re-check the session.
The library is a single live browser: filter tabs across the top
(All · Installed · Updates · Favourites, plus a Friends tab), the game list
with status badges (● installed, ▲ update, ⬇ downloading, ○ not
installed, ♡ favourite), a detail pane with cover art, and a status bar
showing live counts, the active filter/sort, your account, and the aurelia
version. Press ? any time for the full key list.
| Key | Action |
|---|---|
j / ↓, k / ↑ |
Move down / up (mouse wheel works too) |
g / G |
Jump to top / bottom |
PageUp / PageDown |
Page through the list |
Tab / Shift-Tab |
Cycle tabs |
1–5 |
Jump straight to a tab (5 = Friends) |
/ |
Focus the live fuzzy filter (type to narrow, Esc clears) |
s |
Cycle sort (name / installed-first) |
Enter |
Open the Actions menu for the selected game |
i |
Expand / collapse the description panel |
,ct |
Open the selected game’s HowLongToBeat page or retry a failed lookup |
d |
Install / download (pick a library) |
Space / c |
Pause / resume, or cancel, an install |
U / v / x |
Update, verify, or uninstall |
V |
Versions & pinning (downgrade to a manifest) |
b / o / D |
Beta branches, depots, DLC |
P / E |
Proton runtimes, runtime plugins (umu / luxtorpeda / Steam runtime) |
C / W / a / I |
Cloud saves, Workshop, achievements, inventory |
M / K / N / O |
Move, relink, import an install; collections |
m / S / w |
Market listings, market search, wallet |
R |
Running games |
f / H |
Toggle favourite, hide the game |
A / p |
Account, settings (HLTB, presence, proxy) |
r |
Refresh the library from Steam |
l |
Sign in again |
? |
Toggle the help overlay |
q |
Quit |
Enter opens a filterable command palette with every action that applies to the
selected game — type to narrow it, Enter to run. Two entries live only here:
- Play as… lists every way the game can be started (
aurelia launch-targets): the native Linux build, or the Windows build with the in-Wine Steam runtime, the host Steam client, or no Steam. Launching one applies to that run only; unavailable targets say what's missing. - Game settings holds the per-game overrides: runner (auto / umu / luxtorpeda), forced Proton, platform (auto / windows / linux), Steam runtime (auto / on / off), Steam prefix (shared / per-game), and launch script.
Selecting a game fetches its details lazily — developer/publisher metadata
(aurelia info), the ProtonDB compatibility tier, and cover art all load in the
background, so navigation stays responsive while they fill in.
HowLongToBeat completion times also load after selection settles. The detail
pane shows Main Story, Main + Extras, and Completionist times; — means no
submitted time for that style. PCGamingWiki maps Steam IDs to HLTB pages, with
HLTB title search as fallback; matches are verified against HLTB's Steam IDs.
Press ,ct (or choose HowLongToBeat page in
Actions) to open the verified match. The row stays hidden until a result is
available. Cached marks older estimates shown during refresh or retained after
a failed refresh. Failed lookups show Fetch Failed; press ,ct to retry.
See HowLongToBeat for matching,
cache, and troubleshooting details. To disable HLTB lookups and hide its
content, press p, then h; the setting is saved locally.
A little Easter egg for reading the documentation.
f toggles a favourite (shown with a ♡), and the Favourites tab (4) filters
the list down to just your favourites.
H hides the selected game. Hidden games are recorded in
~/.config/aurelia-tui/config.json.
By default only Game and DLC entries are shown. Edit the allowed_games
field in the config to include any of Game, DLC, Driver, Application,
Config, Demo, Tool, or Unknown.
| Path | Contents | Override |
|---|---|---|
~/.config/aurelia-tui/ |
config.json (favourites, hidden games, allowed types, highlight colour, HLTB preference) |
AURELIA_TUI_DIR |
~/.cache/aurelia-tui/ |
cached library (games.json) |
AURELIA_TUI_CACHE_DIR |
~/.cache/aurelia-tui/hltb/ |
cached HowLongToBeat matches and completion times | AURELIA_TUI_CACHE_DIR (parent directory) |
~/.cache/aurelia-tui/hltb/pcgamingwiki/ |
cached Steam-to-HLTB page mappings | AURELIA_TUI_CACHE_DIR (parent directory) |
~/.cache/aurelia-tui/icons/ |
cached cover art | AURELIA_TUI_ICON_DIR |
Launching, Proton/Wine, and runtime concerns are all handled by aurelia play,
so there are no wrapper scripts or separate runtimes to manage on your side.
- steam-tui — the original client this is rebuilt from, by @dmadisetti and contributors
- aurelia — the CLI backend
- steam-vent — Steam protocol implementation
Distributed under GPL-3.0. See LICENSE for details.
