# volk-xp/steam-achievement-manager-gui architecture

> Architecture diagram of the GitHub repository volk-xp/steam-achievement-manager-gui, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/volk-xp/steam-achievement-manager-gui
- Repository: https://github.com/volk-xp/steam-achievement-manager-gui

## Overview

Steam Achievement Manager is a Windows desktop app for viewing and changing achievements on the signed-in Steam account. The user opens an installed game or enters its App ID, reviews and filters achievements, stages unlocks or resets, then applies changes; Steam’s response is shown and the state is reloaded. The app also discovers installed games, supports sidebar removal/restoration, rarity and sorting, and persists preferences and cached counts. The graph follows the sampled entry point, UI, worker, library and Steam modules; README-described capabilities remain within the UI node where implementation detail was not sampled.

Main entry points: [`src/gui/app.rs`](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/app.rs) (Library and achievement UI), [`src/main.rs`](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/main.rs) (Application entry), [`src/config.rs`](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/config.rs) (Settings and cached counts), [`src/library.rs`](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/library.rs) (Installed game discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_entry["Application entry<br/>[main.rs]"]
  node_arguments["App ID arguments<br/>[args.rs]"]
  node_ui["Library and achievement UI<br/>[app.rs]"]
  node_widgets["Interactive widgets<br/>[widgets.rs]"]
  node_theme["Visual theme<br/>[theme.rs]"]
  node_search["Fuzzy search<br/>[search.rs]"]
end

subgraph group_discovery["Game discovery"]
  node_games["Installed game discovery<br/>[library.rs]"]
end

subgraph group_steam["Achievement operations"]
  node_worker["Steam worker<br/>[worker.rs]"]
  node_achievements["Achievement operations<br/>[steam.rs]"]
end

subgraph group_prefs["Preferences"]
  node_config["Settings and cached counts<br/>[config.rs]"]
end

node_user(("User"))
node_steam_api["Steamworks API"]
node_steam_files["Steam library files"]
node_settings_store[("Persisted settings")]

node_user -->|"starts app"| node_entry
node_entry -->|"parses arguments"| node_arguments
node_entry -->|"loads settings"| node_config
node_entry -->|"launches window"| node_ui
node_ui -->|"loads installed games"| node_games
node_ui -->|"uses preferences"| node_config
node_ui -->|"scores search"| node_search
node_ui -->|"draws controls"| node_widgets
node_ui -->|"uses styling"| node_theme
node_ui -->|"sends commands"| node_worker
node_worker -->|"loads and applies"| node_achievements
node_achievements -->|"calls Steamworks"| node_steam_api
node_games -->|"reads manifests"| node_steam_files
node_config -->|"loads and stores"| node_settings_store

click node_entry "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/main.rs"
click node_arguments "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/args.rs"
click node_ui "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/app.rs"
click node_widgets "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/widgets.rs"
click node_theme "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/theme.rs"
click node_search "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/search.rs"
click node_games "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/library.rs"
click node_worker "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/worker.rs"
click node_achievements "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/steam.rs"
click node_config "https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/config.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_entry,node_arguments,node_ui,node_widgets,node_theme,node_search,node_user toneBlue
class node_games,node_settings_store toneAmber
class node_worker,node_achievements,node_steam_api toneMint
class node_config toneRose
class node_steam_files toneIndigo
```

## Components

### Desktop experience

- [Application entry](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/main.rs): `src/main.rs`
- [App ID arguments](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/args.rs): `src/args.rs`
- [Library and achievement UI](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/app.rs): `src/gui/app.rs`
- [Interactive widgets](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/widgets.rs): `src/gui/widgets.rs`
- [Visual theme](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/theme.rs): `src/gui/theme.rs`
- [Fuzzy search](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/search.rs): `src/search.rs`

### Game discovery

- [Installed game discovery](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/library.rs): `src/library.rs`

### Achievement operations

- [Steam worker](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/gui/worker.rs): `src/gui/worker.rs`
- [Achievement operations](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/steam.rs): `src/steam.rs`

### Preferences

- [Settings and cached counts](https://github.com/volk-xp/steam-achievement-manager-gui/blob/main/src/config.rs): `src/config.rs`

### Other components

- **User**
- **Steamworks API**
- **Steam library files**
- **Persisted settings**

## Connections

- User → Application entry: starts app (evidence: `README.md`)
- Application entry → App ID arguments: parses arguments (evidence: `src/main.rs`)
- Application entry → Settings and cached counts: loads settings (evidence: `src/main.rs`)
- Application entry → Library and achievement UI: launches window (evidence: `src/main.rs`)
- Library and achievement UI → Installed game discovery: loads installed games (evidence: `src/gui/app.rs`)
- Library and achievement UI → Settings and cached counts: uses preferences (evidence: `src/gui/app.rs`)
- Library and achievement UI → Fuzzy search: scores search (evidence: `src/gui/app.rs`)
- Library and achievement UI → Interactive widgets: draws controls (evidence: `src/gui/app.rs`)
- Library and achievement UI → Visual theme: uses styling (evidence: `src/gui/app.rs`)
- Library and achievement UI → Steam worker: sends commands (evidence: `src/gui/app.rs`)
- Steam worker → Achievement operations: loads and applies (evidence: `src/gui/worker.rs`)
- Achievement operations → Steamworks API: calls Steamworks (evidence: `README.md`)
- Installed game discovery → Steam library files: reads manifests (evidence: `src/library.rs`)
- Settings and cached counts → Persisted settings: loads and stores (evidence: `src/config.rs`)
