How collinszheng/steamgamepicker works
Steam Game Picker is a Tkinter desktop app that resolves a Steam identity, loads a public game library, lets the user filter and exclude titles, and randomly picks a game with details and a recent-picks history. Startup assembles the window, worker, and Steam client; the worker keeps network calls off the UI thread. The README documents caching, language switching, settings, and certificate-trust fallback. Edges are limited to relationships visible in excerpts, the source index, or README; unsampled implementation details are not inferred.
Main entry points: main_window.py Main window · main.py App assembly · steam_api.py Steam API client · settings_dialog.py Settings dialog
Components 25
App startup
- App assembly
main.py - Background worker
app/worker.py - Cancellation tokens
app/cancellation.py - Redacted logs
app/logging_setup.py - Install language marker
app/language_marker.py
Library and picking
- Game data models
app/models.py - Filters and draw pool
app/pool.py
Steam access
- Identity parsing
app/steamid.py - Steam API client
app/steam_api.py - Steam Web API
- Trust fallback
app/trust.py - Error classification
app/errors.py - Game details
app/steam_api.py
Local data
- Configuration
app/config.py - Library and detail cache
app/cache.py - Pick history
app/history.py
Interface
- Main window
app/ui/main_window.py - Cover images
app/images.py - Draw animation
app/ui/animator.py - History window
app/ui/history_dialog.py - Settings dialog
app/ui/settings_dialog.py - Theme and layout
app/ui/theme.py - Translations
app/i18n.py - UI state mapping
app/state.py
Other components
- User
Connections 32
- User → Main window: uses
README.md - App assembly → Background worker: creates
main.py - App assembly → Steam API client: creates
main.py - App assembly → Main window: assembles
main.py - App assembly → Configuration: loads
main.py - App assembly → Redacted logs: configures
main.py - App assembly → Install language marker: consumes
main.py - Main window → Background worker: submits tasks
app/ui/main_window.py - Background worker → Cancellation tokens: uses
app/worker.py - Main window → Identity parsing: parses input
app/ui/main_window.py - Main window → Steam API client: requests library
README.md - Steam API client → Steam Web API: calls
README.md - Steam API client → Trust fallback: retries with
app/steam_api.py - Steam API client → Error classification: classifies failures
app/steam_api.py - Steam API client → Game data models: returns game data
app/steam_api.py - Main window → Filters and draw pool: filters and draws
app/ui/main_window.py - Filters and draw pool → Game data models: operates on
app/pool.py - Main window → Library and detail cache: uses cached data
app/ui/main_window.py - Main window → Game details: loads details
README.md - Main window → Cover images: loads covers
app/ui/main_window.py - Main window → Draw animation: animates draw
app/ui/main_window.py - Main window → Pick history: records picks
app/ui/main_window.py - History window → Pick history: reads records
app/ui/history_dialog.py - Main window → Settings dialog: opens
app/ui/main_window.py - Settings dialog → Configuration: saves settings
app/ui/settings_dialog.py - Main window → Configuration: uses configuration
app/ui/main_window.py - Main window → Theme and layout: applies theme
app/ui/main_window.py - Settings dialog → Theme and layout: uses theme
app/ui/settings_dialog.py - Main window → Translations: translates interface
app/ui/main_window.py - Settings dialog → Translations: translates controls
app/ui/settings_dialog.py - Main window → UI state mapping: updates controls
app/ui/main_window.py - Library and detail cache → Configuration: uses storage paths
app/cache.py