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.

Instructions

Set up for Windows

• Download the latest sgdboop-win64.zip
• Extract the program in any directory you prefer
• 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

Set up for 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.

Set up for MacOS

brew

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.

---

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

Credits

License

zlib