Mollusk
1f828f1e1a
- Store API key in system keyring instead of plaintext QSettings - Migrate away from plaintext api_key on first save - Redact API key from error messages emitted to the UI - Validate API key (32 hex chars) and Steam ID (17 digits) before use - Apply refresh cooldown when settings dialog triggers a fetch Co-Authored-By: Claude Sonnet 4.6 <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.