Skip to content

This Bash script scans Steam library folders for Proton prefixes, matches them to game names, and lets you select a game via fzf. It opens the chosen game's folder in your Linux file manager , making it easy to find save files or modding locations. A simple tool for managing Steam game files on Linux.

License

Notifications You must be signed in to change notification settings

StoicaTielemans/ProtonFinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

95b9cf8 · Dec 15, 2024

History

10 Commits
Dec 11, 2024
Dec 15, 2024
Dec 15, 2024
Dec 11, 2024

Repository files navigation

ProtonFinder

ProtonFinder is a simple Bash script that scans your Steam library folders for Proton prefixes, maps them to their corresponding game names, and lets you open the selected game’s folder in your default Linux file manager. It's perfect for locating save files or modding your games.



Features

  • Scans multiple Steam library folders for Proton prefixes.
  • Maps prefixes to game names for easy identification.
  • Interactive game selection using fzf.
  • Opens the selected game folder in your Linux file manager.
  • Text-only mode with --text.

How to Set Up

Create and Install the Bash Script

  1. Clone this repository or manually create the script:

    nano protonfinder.sh
  2. Copy the script content into the file and save it.

  3. Make the script executable:

    chmod +x protonfinder.sh
  4. Move the script to /bin for ease of use:

    sudo mv protonfinder.sh /bin/protonfinder

How to Use

  1. Run the script:

    protonfinder
  2. Use the interactive menu (fzf) to select a game.

  3. The script will open the selected game’s folder in your file manager.


Customization

Add Custom Steam Library Paths

To include additional Steam library folders:

  1. Open the script in your editor:

    sudo nano /bin/protonfinder
  2. Add your custom path(s) to the STEAM_FOLDERS array:

    STEAM_FOLDERS=(
        "$HOME/.local/share/Steam/steamapps"
        "/mnt/1TB_SSD/SteamLibrary/steamapps"
        "/your/custom/path/steamapps"
    )
  3. Save and exit.

Change the Default File Manager

To use a different file manager:

  1. Replace nemo at the end of the script with your preferred file manager (e.g., nautilus, dolphin):
    # Example: Using Nautilus instead of Nemo
    nautilus "$LOCAL_PATH"

Text-Only Mode

If you give the argument --text to the ProtonFinder script, it will only print all the games/applications it can find in the terminal. By default, it will only open fzf and nemo and not print anything for a cleaner terminal.

Run with --text: bash protonfinder --text


Requirements

  • fzf: Install it via your package manager (e.g., sudo apt install fzf).
  • A Linux file manager (e.g., Nemo, Nautilus, Dolphin).

About

This Bash script scans Steam library folders for Proton prefixes, matches them to game names, and lets you select a game via fzf. It opens the chosen game's folder in your Linux file manager , making it easy to find save files or modding locations. A simple tool for managing Steam game files on Linux.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages