How 4o66/sunshine-apps-ui works
Sunshine App Manager is a cross-platform UI and engine for discovering installed games, choosing artwork, and safely managing the apps Sunshine offers. The principal workflow is: a user opens the local interface, connects to Sunshine’s configuration, scans Steam/Heroic and launcher sources, reviews artwork and changes, then applies a reconciled apps.json update with a backup. The README documents platform-specific window hosting and optional SteamGridDB artwork. Source excerpts and the index support the main boundaries; some UI and runtime wiring is documented rather than shown in sampled code.
Main entry points: launcher.py App launcher · api.py Core API · run.py Scan orchestrator · server.py Local web interface
Components 27
Interface and hosting
- Local web interface
src/sunshine_apps_ui/server.py - Page rendering
src/sunshine_apps_ui/render.py - Tile localization
src/sunshine_apps_ui/i18n.py
App management engine
- UI engine facade
src/sunshine_apps_ui/engine.py - Core API
src/sunshine_apps_ui/core/api.py - Sunshine API client
src/sunshine_apps_ui/core/sunshine_api.py
Discovery and artwork
- Scan orchestrator
src/sunshine_apps_ui/core/run.py - Steam discovery
src/sunshine_apps_ui/core/sources/steam.py - Heroic discovery
src/sunshine_apps_ui/core/sources/heroic.py - Launcher discovery
src/sunshine_apps_ui/core/sources/launchers.py - System apps
src/sunshine_apps_ui/core/system_apps.py - Artwork candidates
src/sunshine_apps_ui/core/artwork_sources.py - Image processing
src/sunshine_apps_ui/core/images.py
Persistence and safety
- Ownership reconciliation
src/sunshine_apps_ui/core/reconcile.py - Apply mutations
src/sunshine_apps_ui/core/mutate.py - Backup and restore
src/sunshine_apps_ui/core/backups.py - Preferences and state
src/sunshine_apps_ui/state.py - State locations
src/sunshine_apps_ui/places.py
Platform support
- App launcher
src/sunshine_apps_ui/launcher.py - Window host
src/sunshine_apps_ui/gtkhost.py - Windows host
src/sunshine_apps_ui/winhost.py - Browser fallback
src/sunshine_apps_ui/winbrowser.py - Per-user installer
src/sunshine_apps_ui/installer.py
Other components
- User
- Moonlight
- SteamGridDB
- Sunshine service
Connections 31
- User → App launcher: opens manager
- Moonlight → App launcher: launches tile
- App launcher → Local web interface: starts interface
- App launcher → Window host: opens window
src/sunshine_apps_ui/launcher.py - App launcher → Windows host: opens on Windows
src/sunshine_apps_ui/launcher.py - App launcher → Browser fallback: falls back
src/sunshine_apps_ui/launcher.py - User → Local web interface: uses controls
- Local web interface → Page rendering: renders pages
src/sunshine_apps_ui/server.py - Local web interface → UI engine facade: requests operations
src/sunshine_apps_ui/server.py - Local web interface → Preferences and state: reads drafts
src/sunshine_apps_ui/server.py - UI engine facade → Core API: forwards requests
src/sunshine_apps_ui/engine.py - Core API → Scan orchestrator: runs scan
src/sunshine_apps_ui/core/api.py - Scan orchestrator → Steam discovery: discovers games
src/sunshine_apps_ui/core/run.py - Scan orchestrator → Heroic discovery: discovers games
src/sunshine_apps_ui/core/run.py - Scan orchestrator → Launcher discovery: discovers launchers
src/sunshine_apps_ui/core/run.py - Scan orchestrator → System apps: collects system apps
src/sunshine_apps_ui/core/run.py - Scan orchestrator → Artwork candidates: finds artwork
src/sunshine_apps_ui/core/run.py - Steam discovery → Artwork candidates: requests candidates
src/sunshine_apps_ui/core/sources/steam.py - Heroic discovery → Image processing: uses image helpers
src/sunshine_apps_ui/core/sources/heroic.py - Artwork candidates → Image processing: downloads and converts
src/sunshine_apps_ui/core/artwork_sources.py - Artwork candidates → SteamGridDB: searches optionally
- Core API → Ownership reconciliation: plans app changes
src/sunshine_apps_ui/core/api.py - Core API → Apply mutations: applies changes
src/sunshine_apps_ui/core/api.py - Apply mutations → Ownership reconciliation: uses ownership rules
src/sunshine_apps_ui/core/mutate.py - Core API → Backup and restore: lists backups
src/sunshine_apps_ui/core/api.py - Apply mutations → Backup and restore: backs up before writes
src/sunshine_apps_ui/core/mutate.py - Core API → Sunshine API client: checks connection
src/sunshine_apps_ui/core/api.py - Sunshine API client → Sunshine service: reads and reloads
src/sunshine_apps_ui/core/sunshine_api.py - Preferences and state → State locations: locates state
src/sunshine_apps_ui/state.py - Tile localization → Page rendering: supplies tile labels
src/sunshine_apps_ui/render.py - Per-user installer → App launcher: installs entry point
src/sunshine_apps_ui/installer.py