#proton #steam #cross-platform #wine #directory #save-file #file-path

proton-finder

Cross platform library for finding and pathing through proton prefixes

2 stable releases

1.1.0 Oct 1, 2024
1.0.0 May 10, 2024
0.1.0 May 10, 2024

#470 in Filesystem

Download history 12/week @ 2024-07-29 7/week @ 2024-09-16 18/week @ 2024-09-23 171/week @ 2024-09-30

196 downloads per month

MIT license

41KB
750 lines

Proton-Finder

Rust library for finding and working with steams proton prefixes, and accessing common paths within them.
Additionally providing a universal wrapper to allow one codebase for Windows and Linux support.
Crates.io

Purpose

Primary use case is for developing cross plattform modding tools/save file editors.
A lot of games save their save files/load mods from the AppData or Documents folders under Windows (which under Windows are easily accessible with libraries such as dirs).
When running under Linux + Proton (or Wine) these folders are stored within the prefix, and therefore harder to access.

So this library provides functions to allow abstracting these prefixes away, so you can access the same folders on Windows and Linux through universal functions.

Additional linux modul is available when the target_os is Linux, which allows rawer access,
including opening wine prefixes and reading .reg Registry files from the prefix.

Example

let res = proton-finder::get_game_drive(2420510).map_or_else(|e| {
    println!("Steam Dir provided is not correctly formated, ignored...");
    e
}, |k| k);

if let Some(game_drive) = res {
    if let Some(mut path) = game_drive.config_local_dir() {
        path.push("HoloCure");
        path.push("settings.json");

        if let Ok(text) = std::fs::read_to_string(path) {
            println!("{}", text);
        }
    }
} else {
    println!("Unable to find game drive. Did you install the game?");
}

This reads the settings.json for the game HoloCure

Steam root folder priority

Per default, if the env value $STEAM_DIR (same as Protontricks) is set it will use this as the first steam root to search.
You can disable the automatic reading of this env value with the no_tricks features.

After that check the remaining search oder is this:
~/.steam/steam
~/.local/share/Steam
~/.var/app/com.valvesoftware.Steam/data/Steam/ (Flatpak)

Testing

Requires Steam and HoloCure (free game) installed (and launched the game at least once).

Dependencies

~0–10MB
~46K SLoC