SGDBoop

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

Setup Instructions

Windows

1. Download the latest sgdboop-win64.zip
2. Extract the program in any directory you prefer
3. Run it once with Administrator privileges (can be done via Right Click -> Run as Administrator)

To remove from your system and unregister the URL handler:

1. Run unregister.bat as Administrator
2. Delete all the files that came with the program

Linux

Flatpak

Or run flatpak install flathub com.steamgriddb.SGDBoop

Build from source

1. Install the following prerequisites via your distros package manager: make gcc libcurl4-openssl-dev libgtk-3-dev

2. git clone https://github.com/SteamGridDB/SGDBoop.git
   sudo make install -C SGDBoop

Prebuilt binary via install script

1. Download the latest .tar.gz matching your architecture

2. mkdir sgdboop
   tar -zxf sgdboop-linux-*.tar.gz -C sgdboop
   chmod +x sgdboop/install.sh
   sudo ./sgdboop/install.sh

AUR for Arch Linux

Install the AUR package sgdboop or sgdboop-bin. This can be done with an AUR manager like yay: yay -S sgdboop
These packages are maintained and updated by the community.

MacOS

1. Download the latest sgdboop-darwin-universal.zip
2. Extract SGDBoop.app to the /Applications directory
3. Open Terminal and run: xattr -dr com.apple.quarantine /Applications/SGDBoop.app
4. Run SGDBoop from Apps at least once

Once installed, head over to https://www.steamgriddb.com/boop to enable the "BOOP" buttons!

---

Debugging

To enable debugging messages in the log file, set the SGDBOOP_DEBUG environment variable to 1, or create a SGDBOOP_DEBUG (without any extension) file next to the executable.

Credits

License

zlib