mollusk
55c88ecd1f
Steam's official genres list is coarse (~12 entries) and doesn't include
community-relevant categories like Roguelike, Soulslike, or Metroidvania —
those live in Steam's store tags. This adds a second combo box that filters
by store tag, AND'd with the genre filter.
Tag IDs in appinfo.vdf are translated via Steam's IStoreService/GetTagList
endpoint (~450 entries, fetched once on first use, cached at
~/.cache/steam-dice/tags.json). The genre cache file is replaced by
~/.cache/steam-dice/taxonomy.json, which stores both genres and tags per
appid as {"genres": [...], "tags": [...]}; the old genres.json is left in
place as harmless orphan data. Cache merge logic preserves non-empty
fields per appid so the API-fallback genre fetcher doesn't clobber tags
populated from appinfo.vdf.
Tags are appinfo.vdf-only — Steam's appdetails endpoint doesn't return
store_tags, so there's no API fallback. Without python-steam, the tag
combo stays empty and a tooltip-style dialog explains why.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Steam Dice
A small desktop app that picks a random game from your Steam library and lets you launch it directly. Stop staring at your backlog — let the dice decide.
Features
- Rolls a random game from your Steam library and displays its header art
- Installed / Not installed / All filter so you can limit rolls to games you can actually play right now
- Play button launches the selected game immediately via Steam
- Settings dialog for your API key and Steam ID, persisted across sessions
- Refresh button with a 60-second cooldown to avoid hammering the Steam API
- Clean Steam-themed dark UI built with PyQt6
- Wayland-native with X11 fallback
Requirements
Install dependencies with pip:
pip install PyQt6 requests
Or with your distro's package manager, e.g. on Void Linux:
xbps-install python3-PyQt6 python3-requests
Setup
1. Steam API Key
You need a free Steam Web API key to fetch your library.
- Go to steamcommunity.com/dev/apikey and log in.
- Enter any domain name (e.g.
localhost) and click Register. - Copy the 32-character key shown on the page.
2. Steam ID (64-bit)
Your Steam ID is the 17-digit number in your profile URL:
steamcommunity.com/profiles/76561198000000000
^^^^^^^^^^^^^^^^^
this is your ID
If you use a custom profile URL (e.g. steamcommunity.com/id/yourname), look up your numeric ID at steamid.io.
Usage
python steam_dice.py
On first launch the settings dialog will open automatically. Enter your API key and Steam ID, then click Save. Your library loads in the background.
Once loaded:
- Click the dice button to roll a random game
- Use the filter dropdown to restrict rolls to installed or uninstalled games
- Click Play to launch the rolled game via Steam
- Click the refresh button (⟳) to re-fetch your library (60s cooldown applies)
- Click the settings button (⚙) to update your credentials at any time
License
Steam Dice is free software released under the GNU General Public License v2.0.