Gaming Library

Automatically sync your Steam game library to a Notion database. New purchases, playtime, genres, publishers, release dates, and cover art all stay up to date — no manual entry required.

The script runs on a schedule via GitHub Actions: a quick daily sync for playtime changes and new games, plus a monthly full refresh of all game metadata.

📦 Setup

1. Create a Notion Database

Create a Notion database and add the following properties. The names must match exactly:

Property	Type	Description
Name	Title	Game name (default title property)
Steam ID	Number	Unique Steam app ID
Playtime (Minutes)	Number	Total playtime from Steam
Last Played Date	Date	When you last played
Platforms	Multi-select	Game platforms (Steam, PlayStation 5, etc.)
Format	Select	Digital or Physical
Publishers	Multi-select	Game publishers
Developers	Multi-select	Game developers
Genres	Multi-select	Game genres (Action, RPG, etc.)
Release Date	Date	Game release date
Icon	Files & media	Game cover art

You can add any additional properties you want for your own use (e.g. Status, Rating, Notes) — the script will ignore them.

2. Configure Secrets

Fork this repo and add the following as GitHub Actions secrets:

Secret	Description
STEAM_API_KEY	Your Steam Web API key
STEAM_USER_ID	Your 64-bit Steam ID
STEAM_EXCLUDED_GAME_IDS	Comma-separated Steam app IDs to skip (e.g. tools, betas)
NOTION_API_KEY	Your Notion integration API key
NOTION_DATABASE_ID	The ID from your Notion database URL

3. Enable the Workflows

Two GitHub Actions workflows handle everything. See .github/workflows/:

• Daily Sync — Adds new games and updates playtime for recently played games.
• Monthly Sync — Refreshes all game metadata (genres, publishers, release dates, cover art).

Both can be triggered manually from the Actions tab whenever you want.

🎮 Optional: Deku Deals Integration

If you track console games (Switch, PS5, PS4, Xbox) via a Deku Deals collection, you can optionally sync those too. This is entirely opt-in — the script works fine with just Steam.

Additional Setup

1. Add a Deku Deals ID property (Text) to your Notion database. This stores the game slug from Deku Deals.

2. Add the DEKUDEALS_COLLECTION_ID secret to GitHub Actions. You can find your collection ID in the URL when viewing your collection on Deku Deals (e.g. https://www.dekudeals.com/collection/abc123 → abc123).

Secret	Description
DEKUDEALS_COLLECTION_ID	Your Deku Deals collection ID (from the collection URL)

How It Works

• Games are matched between Deku Deals and Notion by name (case-insensitive) or by the Deku Deals ID property.
• If a game already exists in Notion (e.g. from Steam), the Deku Deals platform is added to the Platforms multi-select.
• You can manually set a Deku Deals ID on any Notion entry to explicitly link it to a Deku Deals game.
• Cover art from Deku Deals is used for the Icon property.

💻 Running Locally

You can also run the script on your machine with a .env file containing the same variables listed above.

bundle install
bundle exec ruby lib/run.rb            # daily sync
bundle exec ruby lib/run.rb --full-sync # full metadata refresh

🤖 Claude Code Skills

These skills automate common library management tasks when using Claude Code.

• /dedup-games — Find and resolve duplicate game entries. Scans for edition variants, substring matches, and shared Steam IDs, then walks you through merging or archiving duplicates.

• /add-quest-vr-game — Add Meta Quest VR games to the library. Accepts comma-separated game names (e.g. /add-quest-vr-game Beat Saber, SUPERHOT VR), searches for cover art, confirms with you, and inserts each game with platform "Meta Quest" and format "Digital".

🔧 Development

bundle exec rake test