Steam Leaderboard Updater

A standalone CLI tool that programmatically uploads scores to Steam leaderboards using the Steamworks SDK. Reads configuration from an INI file, auto-detects leaderboard metadata, displays the current top 10, and uploads scores with optional confirmation.

Requirements

• Steam client running and logged into an account that owns the target game

Note

This tool requires the exact leaderboard name to work. You can use steam-leaderboards-finder to retrieve leaderboard names from any Steam game.

Building

Linux

mkdir build && cd build
cmake ..
make

Windows

mkdir build && cd build
cmake ..
cmake --build . --config Release

The build automatically copies the required Steam library (libsteam_api.so or steam_api64.dll) to the output directory.

Configuration

Create a leaderboards.ini file in the same directory as the executable: copy and paste the example leaderboards.ini

Usage

./steam_leaderboards

The tool will:

1. Read leaderboards.ini
2. Initialize Steam API
3. For each leaderboard:
   • Find the leaderboard and display its metadata
   • Show your score and upload method
   • Display the current top 10 entries
   • Ask for confirmation (unless auto_confirm = true)
   • Upload the score and show the result

You might also be interested in

Looking to do the same thing for games using Unity Gaming Services leaderboards? Check out this script.

License

MIT