PROTONUP-RS(1)(|)

📦 version 0.15.0, in ubuntu stonking

✨ PROTONUP-RS 💖

okay bestie, gather round, because protonup-rs is about to become your new obsession 🫶 it's the protonup-rs manual page, and yes we're doing this together, no cap.

🌸 NAME 🌸

protonup-rs — install and manage Proton/Wine and other game runtimes 🎮✨

🎀 SYNOPSIS 🎀

protonup-rs [OPTIONS]

🦋 DESCRIPTION 🦋

so basically protonup-rs is that girl 💅 she automates the installation and update of Linux Gaming Compatibility tools — think GEProton, Luxtorpeda, Boxtron, and a whole squad of others. iconic behaviour, honestly.

run her with no arguments and boom, you're in interactive TUI mode 🌈. wanna go non-interactive (CLI)? that's what all the options below are for, bestie.

💅 OPTIONS 💅

  • -q, --quick-download — skips the menu entirely, auto-detects the apps you've got installed (Steam, Lutris 👀) and downloads the latest versions of their default compatibility tools. lowkey the fastest glow-up route.
  • -f, --force — forces re-installation for tools that already exist, during quick downloads. she said "we're doing this again and I'm not asking" 😤
  • --tool TOOL — the compatibility tool you wanna install. case-insensitive name, so don't stress about capitals fr fr. supported tools:

GEProton (Steam, Lutris), Luxtorpeda (Steam), Boxtron (Steam), VKD3D-Proton (Lutris), Lutris-VKD3D (Lutris), DXVK (Lutris), Kron4ek Wine (Lutris), GEProton RTSP (Steam), Proton CachyOS (Steam, Lutris)

  • --version VERSION — which version to install. use latest for the latest release 🍓. only used together with --tool, okay? don't be out here using it solo.
  • --for TARGET — where to install it. accepted values:

steam, Steam — install to Steam (Native or Flatpak)

lutris, Lutris — install to Lutris (Native or Flatpak)

path — any other value gets treated as a custom installation path (supports ~ expansion ✨)

if you omit it, the target is auto-detected based on the tool's compatible applications and what's actually installed on your system. she's smart like that.

  • -w, --whats-new — shows release notes for the latest versions of the default tools 👑. when combined with -q, it shows release notes before and after downloading. when combined with --tool, it shows release notes for the selected tool and then proceeds with the installation. info first, download second, we love a prepared queen.
  • -h, --help — prints help and dips. periodt.

📁 INSTALL DIRECTORIES 📁

Steam (Native):

~/.steam/steam/compatibilitytools.d/

Steam (Flatpak):

~/.var/app/com.valvesoftware.Steam/data/Steam/compatibilitytools.d/

Lutris (Native):

  • Wine-based tools: ~/.local/share/lutris/runners/wine/
  • Runtime tools: ~/.local/share/lutris/runtime/

Lutris (Flatpak):

  • Wine-based tools: ~/.var/app/net.lutris.Lutris/data/lutris/runners/wine/
  • Runtime tools: ~/.var/app/net.lutris.Lutris/data/lutris/runtime/

Custom:

  • the provided path is used directly (extracted in-place). you're the main character, you pick the spot 🌟

🌈 EXAMPLES 🌈

TUI mode (interactive):

protonup-rs

Quick update (auto-detect and download):

protonup-rs -q

Quick update, force re-install, and show release notes:

protonup-rs -q -f -w

Install latest GEProton for Steam (auto-detected):

protonup-rs --tool GEProton

Install specific version for Lutris:

protonup-rs --tool GEProton --version 8.26 --for lutris

Install to a custom path:

protonup-rs --tool GEProton --version latest --for ~/.local/steam

Force overwrite existing installation:

protonup-rs --tool GEProton --for steam --force

Check release notes without downloading:

protonup-rs --whats-new

🌿 ENVIRONMENT 🌿

  • HOME — used implicitly for resolving ~ in custom paths. that's it, that's the whole job 🎀

protonup-rs does not read any other environment variables for configuration. nope, not a single one, she's low-maintenance.

🧚 TEMPORARY FILES 🧚

downloads get extracted to standard temporary directories ✨

if /tmp has insufficient space, the fallback is:

~/.local/state/protonup-rs/tmp/

these are cleaned up automatically on exit 🧹 so don't worry, she tidies up after herself.

🔥 SEE ALSO 🔥

project homepage: https://github.com/auyer/protonup-rs

API documentation: https://docs.rs/libprotonup

related tools and projects:

👑 AUTHOR 👑

maintained by Rafael Passos (@auyer) — https://rcpassos.me 💜

💀 BUGS 💀

found something cursed? report issues at: https://github.com/auyer/protonup-rs/issues

ngl bestie, if something breaks, just file an issue, no gatekeeping 🙈

so yeah, that's the whole page 🦋 this manual comes to you from the Commands source, User side of things, under the PROTONUP-RS(1)(|) name. slay, install responsibly, and go play your games 💖✨🎀

📦 where this page comes from