Skip to content

edodusi/gaming-library

Repository files navigation

Gaming Library CLI

Search games across your Steam, GOG, Epic Games and Prime Gaming libraries from the command line. Check if you own a game, on which platform, and whether it runs on Linux/SteamOS/Steam Deck.

$ ./gaming search "Tomb Raider"
  + Tomb Raider [steam] — 12.8h played
  + Rise of the Tomb Raider [steam] — 21.6h played
  + Tomb Raider I-III Remastered Starring Lara Croft [gog]
  + Tomb Raider: Anniversary [gog]
  + Rise of the Tomb Raider: 20 Year Celebration [epic]
  + Shadow of the Tomb Raider: Definitive Edition [epic]

$ ./gaming compat "Slay the Spire"
Compatibility: Slay the Spire
  Game: Slay the Spire (Steam AppID: 646570)
  Native Linux: yes
  ProtonDB: platinum
  Steam Deck: verified

Setup

git clone https://github.com/edodusi/gaming-library.git
cd gaming-library
./setup.sh

This creates a Python virtual environment and installs all dependencies (legendary for Epic, nile for Prime Gaming).

Platform login

Steam — requires an API key (free) and your Steam ID:

export STEAM_API_KEY=<your_key>   # get it from steamcommunity.com/dev/apikey
export STEAM_ID=<your_id>         # find it on steamid.io

You can add these to your .bashrc or .zshrc to persist them.

GOG — opens a browser for OAuth login, one-time setup:

./gaming login gog

Epic Games — uses legendary for OAuth:

./gaming login epic

Prime Gaming — uses nile for Amazon login:

./gaming login prime

You don't need all platforms — the tool gracefully skips any that aren't configured.

Usage

Search your libraries

./gaming search "Hades"
./gaming s "Hades"           # short alias

Searches across all configured platforms in priority order: Steam > GOG > Epic > Prime Gaming.

Search with compatibility check

./gaming search "Hades" --compat
./gaming s "Hades" -c

Check compatibility only

Check Linux/SteamOS/Steam Deck compatibility for any game (doesn't need to be in your library):

./gaming compat "Elden Ring"
./gaming c "Elden Ring"

Uses:

  • Steam Store API — native Linux support
  • ProtonDB — community compatibility ratings (platinum/gold/silver/bronze/borked)
  • Steam Deck — Valve's official verification status (verified/playable/unsupported)

Claude Code integration

As a plugin (recommended)

Install as a Claude Code plugin:

/plugin install github:edodusi/gaming-library

Then run setup.sh inside the plugin directory, and use /gaming-library:games <game name>.

Manual

Copy SKILL.md to your project's .claude/commands/games.md and update the path to the gaming wrapper script.

Requirements

  • Python 3.11+
  • requests (installed automatically by setup.sh)
  • legendary-gl (installed automatically, for Epic Games)
  • nile (cloned automatically, for Prime Gaming)

How it works

Platform Method Auth
Steam Web API API key + Steam ID
GOG GOG Galaxy API OAuth2 (browser login)
Epic legendary CLI OAuth2 (browser login)
Prime Gaming nile CLI Amazon login (browser)
Compatibility Steam Store + ProtonDB None (public APIs)

License

MIT

About

Search games across Steam, GOG, Epic and Prime Gaming from the CLI. Check ownership and Linux/SteamOS/Steam Deck compatibility.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages