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.
  • 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.