Proton Prefix Manager is a tool for locating and exploring the Proton prefixes created by Steam on Linux. It offers both a command line interface and a simple graphical interface built with egui.
Steam uses Proton prefixes (Wine environments) to run Windows games on Linux. This project helps you discover where those prefixes are stored so you can inspect or manage them. You can search your installed games, locate the prefix for a specific game, and open it in your file manager. When run without any arguments, the application launches a GUI that lists your games and shows prefix details.
When multiple Steam users exist, Proton Prefix Manager checks loginusers.vdf under Steam's config directory and uses the account marked with "MostRecent" "1". If that file is missing, the tool falls back to ~/.steam/config/loginusers.vdf and ~/.steam/root/config/loginusers.vdf. loginusers.vdf stores 64-bit SteamIDs, which the tool converts to their 32-bit account IDs when resolving the corresponding localconfig.vdf. Launch options are read from and written to that user's localconfig.vdf.
- Install Rust and
cargo. - Clone the repository and build:
The resulting binary will be located at
git clone https://github.com/D1G1T4L3CH0/proton-prefix-manager.git cd proton-prefix-manager cargo build --releasetarget/release/proton-prefix-manager.
Alternatively, you can install directly from the source using:
cargo install --path .Run the program without arguments to launch the GUI:
proton-prefix-managerThe GUI lists your installed Steam games and shows details about each prefix. You can copy or open the prefix path, run Protontricks for the selected game, launch winecfg, and follow external links such as SteamDB or ProtonDB. Game settings let you choose from built‑in and custom Proton versions discovered in compatibilitytools.d.
Icons are bundled with the application via the egui-phosphor crate, so no extra font setup is required.
Search for games by name:
proton-prefix-manager search "portal"Find the prefix path for a specific AppID:
proton-prefix-manager prefix 620Open a prefix in your file manager:
proton-prefix-manager open 620Open the Steam userdata directory for a game:
proton-prefix-manager userdata 620Back up a prefix (stored in ~/.local/share/proton-prefix-manager/backups):
proton-prefix-manager backup 620Restore a prefix from a backup directory:
proton-prefix-manager restore 620 /path/to/backupList backups for a game:
proton-prefix-manager list-backups 620Delete a backup:
proton-prefix-manager delete-backup /path/to/backupReset a prefix:
proton-prefix-manager reset 620Warning: Resetting a prefix will permanently delete it. It's prudent to create a backup of your important data or configuration files before performing this or any other critical action so you can restore your system if something goes wrong.
Clear shader cache:
proton-prefix-manager clear-cache 620Run protontricks in GUI mode for a specific AppID:
proton-prefix-manager protontricks 620 --guiRun protontricks with a specific Winetricks verb:
proton-prefix-manager protontricks 620 dotnet40Launch winecfg:
proton-prefix-manager winecfg 620Show detected localconfig.vdf paths:
proton-prefix-manager config-pathsThe CLI supports JSON (--json), plain text (--plain), and custom-delimited output using --delimiter.
Use --debug to print detailed information about paths and files the application interacts with. This enables verbose logging without having to set the RUST_LOG environment variable.
You can still set RUST_LOG=debug for low level logging from dependencies, but in most cases the --debug flag is sufficient.
- Provide an easy way to locate Proton prefixes for troubleshooting or modding
- Offer both CLI and GUI workflows in a single binary
- Remain lightweight with minimal dependencies
- Serve as a foundation for more advanced prefix management features in the future
This project is released under the MIT license. Contributions are welcome!