SGDBoop

SGDBoop is a tool that automatically applies assets from SteamGridDB directly to your Steam library with a click of a button, removing the need to download and set them manually.

Source code available on GitHub

  1. Install SGDBoop
    • Windows
      1. Download for Windows
      2. Extract the the program in any directory you prefer.
      3. Run it once with Administrator privileges (can be done via Right Click → Run as Administrator)
    • Linux (Flatpak)
      Download on Flathub

      Or run flatpak install flathub com.steamgriddb.SGDBoop

    • Linux (Binaries)

      The install script will move SGDBoop to /usr/local/bin, install the .desktop, then set it to handle the sgdb:// protocol.

      wget https://github.com/SteamGridDB/SGDBoop/releases/latest/download/sgdboop-linux64.tar.gz
      mkdir sgdboop-linux64
      tar -zxf sgdboop-linux64.tar.gz -C sgdboop-linux64
      chmod +x sgdboop-linux64/install.sh
      sudo ./sgdboop-linux64/install.sh
    • Linux (From source)
      1. Install the following prerequisites via your distros package manager: make gcc libcurl4-openssl-dev
      2. git clone https://github.com/SteamGridDB/SGDBoop.git
        sudo make install -C SGDBoop
  2. Test browser integration

    Your browser will ask you if you want to launch a program to handle the sgdb:// protocol. We suggest selecting "Always allow" when given the option.

    Show a test popup!

    You should see popup saying "SGDBoop is working!" If not, refer to the troubleshooting section.

  3. Enable the buttons

    Flip this giant switch to show the & buttons while browsing around SteamGridDB.

  4. Try it out!

    These buttons will now appear while hovering over assets, specific asset pages, and in the "View Original Steam Assets" popup.

    will change assets for Steam games.

    will let you select non-Steam apps or Source/GoldSrc mods to change.

    You will immediately see changes on Windows, on Linux you may need to restart Steam. Icons require a restart regardless of operating system. You cannot change icons on Source or GoldSrc mods.

Troubleshooting

  • The test popup doesn't show when clicking the button in step 2.
    • Unset and re-set the default action for sgdb in your browser settings. (Firefox instructions here)
    • Restart your browser.
    • Restart your whole PC.
    • Try another browser.
    • (Steam Deck) Go in and out of gaming mode.
    • (Steam Deck) After switching to desktop mode, wait a few seconds before opening a browser.
    • (Steam Deck) Restart xdg-desktop-portal after entering Desktop Mode.

      Run systemctl restart --user xdg-desktop-portal once you enter Desktop Mode.

      Instructions to do this automatically every time.
      1. Enter Desktop Mode.
      2. Open settings, go to "Startup and Shutdown" → "Autostart".
      3. Click "Add" at the bottom of the window then select "Add Application".
      4. Select Konsole (under the System group), and in the bottom of the window expand the "Terminal Options" menu and select "Run in terminal".
      5. The new "Konsole" entry will appear on the list. Click the "Properties" button of that entry (has a square-like icon).
      6. Go to the Applications tab.
      7. Change the command to systemctl restart --user xdg-desktop-portal
      8. [Optional] Change the name to something like "Restart xdg-desktop-portal".
      9. Perform a reboot to apply the fix.

      Note: This "fix" is simply a workaround, Valve needs to fix this properly. See ValveSoftware/SteamOS#775 for more info.

  • Assets are not changing.
    • Restart Steam completely. (Open the "Steam" drop-down menu on the top-left of Steam then choose "Exit").
    • Try the test button on step 2 to make sure your browser is still calling BOOP.

If you have any problems please open an issue on GitHub or contact us on Discord.