# maes773/universal-game-launcher architecture

> Architecture diagram of the GitHub repository maes773/universal-game-launcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maes773/universal-game-launcher
- Repository: https://github.com/maes773/universal-game-launcher

## Overview

UGL is a local Windows game launcher: users import a game folder or Steam library, manage the resulting library and achievements, then launch a selected game. The documented architecture puts Slint behind the Core application layer, which coordinates persistence and integrations. The graph preserves the README’s import, launch, icon, settings, and periodic achievement capabilities. Some implementation links rely on the SOURCE INDEX or README because the relevant source was not excerpted; uncertain runtime wiring is omitted.

Main entry points: [`crates/ugl-core/src/application.rs`](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/application.rs) (Core application), [`crates/ugl-core/src/database/mod.rs`](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/database/mod.rs) (SQLite database), [`crates/ugl-app/src/main.rs`](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/src/main.rs) (App shell), [`crates/ugl-core/src/process_manager.rs`](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/process_manager.rs) (Game launcher)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_ui["Slint window<br/>[main.slint]"]
  node_app["App shell<br/>[main.rs]"]
end

subgraph group_core["Core coordination"]
  node_core["Core application<br/>[application.rs]"]
  node_domain["Domain types<br/>[domain.rs]"]
  node_process["Game launcher<br/>[process_manager.rs]"]
end

subgraph group_library["Library and storage"]
  node_registry["Game registry<br/>[registry.rs]"]
  node_database[("SQLite database<br/>[mod.rs]")]
  node_migrations["Schema migrations<br/>[migrations.rs]"]
  node_settings["User settings<br/>[settings.rs]"]
  node_achievements["Achievement store"]
end

subgraph group_integrations["Game integrations"]
  node_manual["Folder import<br/>[manual.rs]"]
  node_steam["Steam library scan<br/>[steam.rs]"]
  node_vdf["VDF parser<br/>[vdf.rs]"]
  node_achievement_scan["Steam achievement reader"]
  node_binary_kv["Binary KeyValues<br/>[binary_kv.rs]"]
end

subgraph group_support["Runtime support"]
  node_watcher["Directory watcher<br/>[watcher.rs]"]
  node_icons["Game icons<br/>[icons.rs]"]
  node_app_icons["Windows icon extraction<br/>[game_icons.rs]"]
  node_png["PNG utilities<br/>[png.rs]"]
  node_net["Network utilities<br/>[net.rs]"]
  node_diagnostics["Diagnostics logging<br/>[diagnostics.rs]"]
  node_paths["Data paths<br/>[paths.rs]"]
end

node_user(("Player"))
node_steam_client(("Steam client"))
node_game_files["Local game files"]

node_user -->|"uses"| node_ui
node_ui -->|"dispatches"| node_app
node_app -->|"calls"| node_core
node_core -->|"coordinates"| node_registry
node_core -->|"opens"| node_database
node_core -->|"reads and writes"| node_settings
node_core -->|"imports"| node_manual
node_core -->|"imports"| node_steam
node_steam -->|"parses with"| node_vdf
node_core -->|"refreshes"| node_achievement_scan
node_achievement_scan -->|"parses with"| node_binary_kv
node_core -->|"stores and lists"| node_achievements
node_achievements -->|"writes records"| node_database
node_registry -->|"queries and updates"| node_database
node_database -->|"runs"| node_migrations
node_core -->|"launches games"| node_process
node_process -->|"starts executable"| node_game_files
node_process -->|"opens Steam URI"| node_steam_client
node_core -.->|"refreshes periodically"| node_watcher
node_core -->|"manages icons"| node_icons
node_icons -->|"uses"| node_png
node_app -.->|"extracts icons"| node_app_icons
node_core -->|"uses types"| node_domain
node_core -->|"logs events"| node_diagnostics
node_achievement_scan -->|"uses utilities"| node_net

click node_ui "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/ui/main.slint"
click node_app "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/src/main.rs"
click node_core "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/application.rs"
click node_domain "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/domain.rs"
click node_registry "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/registry.rs"
click node_database "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/database/mod.rs"
click node_migrations "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/database/migrations.rs"
click node_settings "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/settings.rs"
click node_manual "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/manual.rs"
click node_steam "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/steam.rs"
click node_vdf "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/vdf.rs"
click node_achievement_scan "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/steam_achievements.rs"
click node_binary_kv "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/binary_kv.rs"
click node_achievements "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/achievement_engine.rs"
click node_process "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/process_manager.rs"
click node_watcher "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/watcher.rs"
click node_icons "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/icons.rs"
click node_app_icons "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/src/game_icons.rs"
click node_png "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/png.rs"
click node_net "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/net.rs"
click node_diagnostics "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/diagnostics.rs"
click node_paths "https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/paths.rs"

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_ui,node_app,node_steam_client toneBlue
class node_core,node_domain,node_process toneAmber
class node_registry,node_database,node_migrations,node_settings,node_achievements toneMint
class node_manual,node_steam,node_vdf,node_achievement_scan,node_binary_kv toneRose
class node_watcher,node_icons,node_app_icons,node_png,node_net,node_diagnostics,node_paths,node_user,node_game_files toneIndigo
```

## Components

### User interface

- [Slint window](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/ui/main.slint): `crates/ugl-app/ui/main.slint`
- [App shell](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/src/main.rs): `crates/ugl-app/src/main.rs`

### Core coordination

- [Core application](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/application.rs): `crates/ugl-core/src/application.rs`
- [Domain types](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/domain.rs): `crates/ugl-core/src/domain.rs`
- [Game launcher](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/process_manager.rs): `crates/ugl-core/src/process_manager.rs`

### Library and storage

- [Game registry](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/registry.rs): `crates/ugl-core/src/registry.rs`
- [SQLite database](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/database/mod.rs): `crates/ugl-core/src/database/mod.rs`
- [Schema migrations](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/database/migrations.rs): `crates/ugl-core/src/database/migrations.rs`
- [User settings](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/settings.rs): `crates/ugl-core/src/settings.rs`
- [Achievement store](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/achievement_engine.rs): `crates/ugl-core/src/achievement_engine.rs`

### Game integrations

- [Folder import](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/manual.rs): `crates/ugl-core/src/integrations/manual.rs`
- [Steam library scan](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/steam.rs): `crates/ugl-core/src/integrations/steam.rs`
- [VDF parser](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/vdf.rs): `crates/ugl-core/src/integrations/vdf.rs`
- [Steam achievement reader](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/steam_achievements.rs): `crates/ugl-core/src/integrations/steam_achievements.rs`
- [Binary KeyValues](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/integrations/binary_kv.rs): `crates/ugl-core/src/integrations/binary_kv.rs`

### Runtime support

- [Directory watcher](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/watcher.rs): `crates/ugl-core/src/watcher.rs`
- [Game icons](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/icons.rs): `crates/ugl-core/src/icons.rs`
- [Windows icon extraction](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-app/src/game_icons.rs): `crates/ugl-app/src/game_icons.rs`
- [PNG utilities](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/png.rs): `crates/ugl-core/src/png.rs`
- [Network utilities](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/net.rs): `crates/ugl-core/src/net.rs`
- [Diagnostics logging](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/diagnostics.rs): `crates/ugl-core/src/diagnostics.rs`
- [Data paths](https://github.com/maes773/universal-game-launcher/blob/main/crates/ugl-core/src/paths.rs): `crates/ugl-core/src/paths.rs`

### Other components

- **Player**
- **Steam client**
- **Local game files**

## Connections

- Player → Slint window: uses (evidence: `README.md`)
- Slint window → App shell: dispatches (evidence: `README.md`)
- App shell → Core application: calls (evidence: `README.md`)
- Core application → Game registry: coordinates (evidence: `crates/ugl-core/src/application.rs`)
- Core application → SQLite database: opens (evidence: `crates/ugl-core/src/application.rs`)
- Core application → User settings: reads and writes (evidence: `crates/ugl-core/src/application.rs`)
- Core application → Folder import: imports (evidence: `crates/ugl-core/src/application.rs`)
- Core application → Steam library scan: imports (evidence: `crates/ugl-core/src/application.rs`)
- Steam library scan → VDF parser: parses with (evidence: `crates/ugl-core/src/integrations/steam.rs`)
- Core application → Steam achievement reader: refreshes (evidence: `crates/ugl-core/src/application.rs`)
- Steam achievement reader → Binary KeyValues: parses with (evidence: `crates/ugl-core/src/integrations/steam_achievements.rs`)
- Core application → Achievement store: stores and lists (evidence: `crates/ugl-core/src/application.rs`)
- Achievement store → SQLite database: writes records (evidence: `crates/ugl-core/src/achievement_engine.rs`)
- Game registry → SQLite database: queries and updates (evidence: `crates/ugl-core/src/registry.rs`)
- SQLite database → Schema migrations: runs (evidence: `crates/ugl-core/src/database/mod.rs`)
- Core application → Game launcher: launches games (evidence: `crates/ugl-core/src/application.rs`)
- Game launcher → Local game files: starts executable (evidence: `README.md`)
- Game launcher → Steam client: opens Steam URI (evidence: `README.md`)
- Core application → Directory watcher: refreshes periodically (evidence: `README.md`)
- Core application → Game icons: manages icons (evidence: `crates/ugl-core/src/application.rs`)
- Game icons → PNG utilities: uses (evidence: `crates/ugl-core/src/icons.rs`)
- App shell → Windows icon extraction: extracts icons (evidence: `README.md`)
- Core application → Domain types: uses types (evidence: `crates/ugl-core/src/application.rs`)
- Core application → Diagnostics logging: logs events (evidence: `crates/ugl-core/src/application.rs`)
- Steam achievement reader → Network utilities: uses utilities (evidence: `crates/ugl-core/src/integrations/steam_achievements.rs`)
