# chaszl/paradise_game_launcher architecture

> Architecture diagram of the GitHub repository chaszl/paradise_game_launcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chaszl/paradise_game_launcher
- Repository: https://github.com/chaszl/paradise_game_launcher

## Overview

Paradise Launcher is a Windows desktop game-library launcher. Users configure one folder of shortcuts or game subfolders; the window loads games, enriches them with artwork and install status, and lets users browse, categorize, and launch them. The README also documents settings, recents, and hardware gauges. MainWindow source is excerpted, so some UI wiring and startup details are not visible; links are limited to documented behavior or evident service responsibilities.

Main entry points: [`MainWindow.xaml.cs`](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs) (Launcher window), [`SteamGridService.cs`](https://github.com/chaszl/paradise_game_launcher/blob/main/SteamGridService.cs) (Artwork lookup), [`GameData.cs`](https://github.com/chaszl/paradise_game_launcher/blob/main/GameData.cs) (Game records), [`MainWindow.xaml`](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml) (WPF interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Library workflow"]
  node_window["Launcher window<br/>[MainWindow.xaml.cs]"]
  node_view["WPF interface<br/>[MainWindow.xaml]"]
  node_games["Game records<br/>[GameData.cs]"]
  node_scan["Library scan<br/>[MainWindow.xaml.cs]"]
  node_detect["Install detection"]
  node_launch["Game launching<br/>[Launcher.cs]"]
end

subgraph group_metadata["Game enrichment"]
  node_art["Artwork lookup"]
  node_steamgrid["SteamGridDB"]
  node_assets[("Artwork cache")]
end

subgraph group_preferences["Settings and state"]
  node_settings["App settings<br/>[AppSettings.cs]"]
  node_settingsfile[("Settings file")]
  node_categories["Category data<br/>[AppSettings.cs]"]
  node_categoryfiles[("Category files")]
  node_recents["Recent games<br/>[MainWindow.xaml.cs]"]
end

subgraph group_runtime["Desktop runtime"]
  node_monitor["Hardware metrics"]
  node_hardware["Hardware sensors"]
end

node_user(("Player"))

node_user -->|"uses"| node_view
node_view -->|"drives"| node_window
node_window -->|"loads and saves"| node_settings
node_settings -->|"reads and writes"| node_settingsfile
node_window -->|"scans configured folder"| node_scan
node_scan -->|"creates records"| node_games
node_window -->|"requests metadata"| node_art
node_art -.->|"searches and downloads"| node_steamgrid
node_art -->|"checks and caches"| node_assets
node_art -->|"loads and saves"| node_categories
node_categories -->|"reads and writes"| node_categoryfiles
node_window -->|"checks install status"| node_detect
node_detect -->|"reads install records"| node_hardware
node_window -->|"launches selected game"| node_launch
node_launch -->|"reads game path"| node_games
node_window -->|"maintains recent list"| node_recents
node_window -->|"polls metrics"| node_monitor
node_monitor -->|"reads sensors"| node_hardware
node_window -->|"updates library display"| node_games

click node_window "https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs"
click node_view "https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml"
click node_games "https://github.com/chaszl/paradise_game_launcher/blob/main/GameData.cs"
click node_scan "https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs"
click node_detect "https://github.com/chaszl/paradise_game_launcher/blob/main/LauncherDetectionService.cs"
click node_launch "https://github.com/chaszl/paradise_game_launcher/blob/main/Launcher.cs"
click node_art "https://github.com/chaszl/paradise_game_launcher/blob/main/SteamGridService.cs"
click node_settings "https://github.com/chaszl/paradise_game_launcher/blob/main/AppSettings.cs"
click node_categories "https://github.com/chaszl/paradise_game_launcher/blob/main/AppSettings.cs"
click node_recents "https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs"
click node_monitor "https://github.com/chaszl/paradise_game_launcher/blob/main/HardwareMonitorService.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_window,node_view,node_games,node_scan,node_detect,node_launch toneBlue
class node_art,node_steamgrid,node_assets toneAmber
class node_settings,node_settingsfile,node_categories,node_categoryfiles,node_recents toneMint
class node_monitor,node_hardware toneRose
class node_user toneIndigo
```

## Components

### Library workflow

- [Launcher window](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [WPF interface](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml): `MainWindow.xaml`
- [Game records](https://github.com/chaszl/paradise_game_launcher/blob/main/GameData.cs): `GameData.cs`
- [Library scan](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`
- [Install detection](https://github.com/chaszl/paradise_game_launcher/blob/main/LauncherDetectionService.cs): `LauncherDetectionService.cs`
- [Game launching](https://github.com/chaszl/paradise_game_launcher/blob/main/Launcher.cs): `Launcher.cs`

### Game enrichment

- [Artwork lookup](https://github.com/chaszl/paradise_game_launcher/blob/main/SteamGridService.cs): `SteamGridService.cs`
- **SteamGridDB**
- **Artwork cache**

### Settings and state

- [App settings](https://github.com/chaszl/paradise_game_launcher/blob/main/AppSettings.cs): `AppSettings.cs`
- **Settings file**
- [Category data](https://github.com/chaszl/paradise_game_launcher/blob/main/AppSettings.cs): `AppSettings.cs`
- **Category files**
- [Recent games](https://github.com/chaszl/paradise_game_launcher/blob/main/MainWindow.xaml.cs): `MainWindow.xaml.cs`

### Desktop runtime

- [Hardware metrics](https://github.com/chaszl/paradise_game_launcher/blob/main/HardwareMonitorService.cs): `HardwareMonitorService.cs`
- **Hardware sensors**

### Other components

- **Player**

## Connections

- Player → WPF interface: uses
- WPF interface → Launcher window: drives
- Launcher window → App settings: loads and saves
- App settings → Settings file: reads and writes
- Launcher window → Library scan: scans configured folder
- Library scan → Game records: creates records
- Launcher window → Artwork lookup: requests metadata
- Artwork lookup → SteamGridDB: searches and downloads
- Artwork lookup → Artwork cache: checks and caches
- Artwork lookup → Category data: loads and saves
- Category data → Category files: reads and writes
- Launcher window → Install detection: checks install status
- Install detection → Hardware sensors: reads install records
- Launcher window → Game launching: launches selected game
- Game launching → Game records: reads game path
- Launcher window → Recent games: maintains recent list
- Launcher window → Hardware metrics: polls metrics
- Hardware metrics → Hardware sensors: reads sensors
- Launcher window → Game records: updates library display
