A fast, careful game launcher for Linux, built with Rust and Qt Quick.
Keep your installed native and Windows games in one good-looking library, launch them through UMU and Proton, and see exactly what happened when something goes wrong.
Note
Rustris is in early development. There is no packaged release yet; you can build it from source and try it with your own games. See Project status for what has and has not been tested.
- Highlights
- Screenshots
- Features
- Project status
- Building from source
- Installing for your user
- Using Rustris
- Where your data lives
- Architecture
- Development
- Acknowledgements
- License
- ๐ฎ One library for native and Windows games โ add the games you already have installed, with a grid, an artwork wall or a compact list.
- ๐ท UMU / Proton made visible โ Rustris finds the Proton builds and Steam Linux Runtimes on your computer and fills in the paths for you.
- ๐ A launch review you can trust โ before a Windows game first starts, see the exact runner, prefix, arguments and environment. Approve once; Rustris asks again only if something changes.
- ๐ก๏ธ Protective by default โ a Wine prefix made by a different Proton is never launched, no shell ever interprets your commands, and nothing is installed, updated or repaired behind your back.
- ๐ Sessions and logs โ live output, preflight evidence, safe Stop and an explicit Force stop; games keep running and logging even if you close the launcher.
- ๐ผ๏ธ Artwork your way โ pick your own images, or let Rustris download covers and banners from SteamGridDB and the Steam Store (off until you turn it on).
- โจ๏ธ Keyboard and screen-reader friendly โ every control is named for assistive technology and the whole app works from the keyboard.
- Add any installed game by name and executable path; arguments are separate tokens (spaces stay inside an argument) and environment variables can be set, set empty or explicitly unset.
- Search, favourites, three views and a detail page for each game with Overview, Configuration, Files and Logs tabs.
- Paths, arguments and environment values are stored as exact bytes, so unusual file names
survive untouched. An exact Unix bytes mode lets you edit them as
\xHHescapes. - Removing a game only removes Rustris's record โ never the game itself.
- The Runners page lists the
umu-runlauncher, every Proton build in Steam'scompatibilitytools.dandsteamapps/commonfolders (and/usr/share/steam), and the Steam Linux Runtimes prepared by UMU. Choosing a build fills in all three paths; Advanced settings keeps the manual fields. - Any detected build can be used. The combinations Rustris has been tested with are marked Validated; others are labelled Not validated.
- A Proton build that needs a different runtime than the selected one is refused with a clear explanation.
- Each game uses an existing flat Wine prefix. If the prefix was created by a different Proton version, Rustris refuses to launch rather than silently converting it.
- Runner updates,
protonfixesand automatic installers are disabled for launches.
The first time a Windows game starts, Rustris shows everything it is about to do: the UMU, Proton and runtime versions, the effective prefix, the program, its arguments and environment, and the evidence it collected. Once you approve, Play starts the game directly until any of those details change โ edit the profile or pick another runner and the review appears again.
- A separate helper process,
rustris-session, owns each running game, so closing the launcher can keep games and their logs alive; reopen Rustris to reconnect. - Stop signals only processes Rustris verified it started. Force stop needs a prior Stop and a confirmation.
- Output is captured with clear limits (16 MiB per log, 256 MiB total) and visible counters if anything is dropped.
- Pick any local image for a game; Rustris keeps a reference and never modifies or deletes it.
- Turn on Download artwork automatically in Settings to fetch a cover and a wide banner when you add a game, or for your whole library at once. Rustris asks SteamGridDB first if you saved your own free API key, then the Steam Store. Only game names are sent, and only while the setting is on.
- Games without artwork get a generated landscape cover, so the library always looks complete.
Rustris is a work in progress and has not been released. What exists today has been exercised mostly in automated, private test desktops:
| Area | State |
|---|---|
| Library, profiles, favourites, search, artwork | Working; covered by automated desktop tests at 1ร, 1.5ร and 2ร scaling |
| Native Linux games | Working; tested with a real native title up to window and Stop |
| Windows games via UMU / Proton | Working with the validated sets below; other builds are allowed but untested |
| Sessions, logs, Stop and reconnect | Working; covered by automated tests |
| Automatic artwork | Working with the Steam Store; SteamGridDB needs your own key |
| Gameplay, audio, controllers, networking in games | Not verified |
| Import from Steam, Lutris or Heroic | Not available yet โ games are added by hand |
| Packages (Flatpak, AppImage, distro) | Not available yet |
Validated runner sets: UMU 1.4.3 with UMU-Proton-10.0-4 and Steam Linux Runtime 3.0 (sniper)
3.0.20260805.254768, or GE-Proton11-5 (build 1786437966) with Steam Linux Runtime 4.0
4.0.20261021.265997.
Warning
Launching a game can change its files, its saves and its Wine prefix, as playing normally would. Back up any prefix you care about before trying it with Rustris.
- Linux (developed on CachyOS / Arch, x86_64)
- Rust 1.98.1 (installed automatically from
rust-toolchain.tomlby rustup) - A C++17 compiler and
pkg-config - Qt 6.12: Core, Gui, Qml, Quick, Quick Controls 2, Quick Dialogs and Quick Effects, with their development files
- For Windows games: umu-launcher, a Proton build and the matching Steam Linux Runtime (UMU prepares the runtime)
On Arch-based systems:
sudo pacman -S --needed base-devel rustup qt6-base qt6-declarativegit clone https://github.com/PerkyZZ999/Rustris.git
cd Rustris
cargo build --release --workspace --lockedThis produces two programs in target/release/: rustris (the desktop app) and
rustris-session (the helper that owns running games). Keep them in the same folder.
Run it straight away with:
./target/release/rustrisThere are no packages yet. To install the build for your account with a menu entry:
install -Dm755 target/release/rustris ~/.local/bin/rustris
install -Dm755 target/release/rustris-session ~/.local/bin/rustris-session
cat > ~/.local/share/applications/rustris.desktop <<EOF
[Desktop Entry]
Type=Application
Name=Rustris
Comment=Linux game launcher for existing local installations
Exec=$HOME/.local/bin/rustris
Icon=applications-games
Terminal=false
Categories=Game;
EOF- Add a game โ press Add game (or
Ctrl+N), give it a name and choose its executable with Browseโฆ. - Windows games โ on the Runners page pick a Proton build, then in the game's configuration choose UMU / Proton and its Wine prefix folder.
- Play โ native games start right away; Windows games show the launch review the first time.
- Follow along โ the game's Logs tab and the Sessions page show output and status.
A longer walkthrough is in docs/GETTING_STARTED.md.
| Shortcut | Action |
|---|---|
Ctrl+N |
Add a game |
Ctrl+F / Ctrl+K |
Search |
Ctrl+S |
Save the profile being edited |
Ctrl+B |
Collapse or expand the sidebar |
Arrow keys, Enter |
Move through the library and open a game |
Escape |
Back to the library |
| What | Default location |
|---|---|
| Library database | ~/.local/share/rustris/library.sqlite3 |
| Downloaded artwork | ~/.local/share/rustris/artwork/ |
| Preferences, runner selection, artwork settings | ~/.config/rustris/ |
| Session logs | ~/.local/state/rustris/logs/ |
XDG_DATA_HOME, XDG_CONFIG_HOME and XDG_STATE_HOME are respected. All of these are private
to your user (folders 0700, files 0600). Before a library upgrade Rustris keeps a verified
backup of the previous version next to it. Quit Rustris before copying the data folder, and if
it reports a database error, keep the folder as it is rather than deleting the file.
QML interface โโโบ CXX-Qt bridge โโโบ bounded queues โโโบ Rust workers โโโบ SQLite
โ
โโโบ session worker โโโบ rustris-session helper โโโบ game
โโโบ artwork worker โโโบ SteamGridDB / Steam Store
| Crate | Role |
|---|---|
crates/rustris-core |
Qt-free core: library storage and migrations, profiles, UMU preparation, runner detection, sessions, artwork |
crates/rustris-ui |
The CXX-Qt bridge and the QML interface resources |
apps/desktop |
The rustris executable |
apps/session-helper |
The rustris-session helper that starts, watches and stops games |
The Qt thread never touches files, processes or the network; that work happens on dedicated workers and the results are handed back as owned snapshots. Games are started with separate argument tokens and an explicit environment โ never through a shell.
cargo fmt --all --check
cargo clippy --workspace --all-targets --locked -- -D warnings
cargo test --workspace --locked
bash tests/check.sh # all of the above plus dependency and contrast checksThe tests/ folder also contains a desktop test harness that runs the real application inside a
private, offline KDE Plasma (KWin) session and drives it through the accessibility tree. It
needs a test build (cargo build --workspace --features test-support --locked), KWin, bwrap
and the AT-SPI Python bindings; for example:
python3 tests/desktop_session.py --root /tmp/rustris-suite --scale 1 --suite \
--application target/debug/rustrisThe default build never contains the test hooks.
- LutrisArtFetcher โ the artwork matching rules come from this sister project.
- SteamGridDB and the Steam Store for artwork.
- umu-launcher, Proton and Proton-GE, which do the hard work of running Windows games.
- CXX-Qt for the Rust โ Qt bridge.
Rustris is released under the MIT License.






