# jingjo07/wuwavh-linux-launcher architecture

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

- Interactive diagram: https://gitdiagram.com/jingjo07/wuwavh-linux-launcher
- Repository: https://github.com/jingjo07/wuwavh-linux-launcher

## Overview

WuWaVH is a Linux desktop launcher for Wuthering Waves, embedding a JavaScript interface in a GTK/WebKit window. The main workflow is user action → frontend IPC → Python handler → game management or a feature backend; those features install Vietnamese localization, manage fonts and game settings, and launch the game. Separate capabilities include performance presets, theme selection, Steam/Heroic support, and launcher self-updates. The graph reflects documented features and sampled routing; some backend internals are unsampled, so uncertain links are omitted.

Main entry points: [`backend/game.py`](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/game.py) (Game detection and launch), [`launcher.py`](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/launcher.py) (GTK/WebKit shell), [`backend/downloader.py`](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/downloader.py) (Vietnamese localization download), [`backend/launcher_update.py`](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/launcher_update.py) (Launcher self-update)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop interface"]
  node_ui["Launcher interface<br/>[app.js]"]
  node_themes["Theme choices<br/>[themes.js]"]
  node_shell["GTK/WebKit shell<br/>[launcher.py]"]
end

subgraph group_game["Game management"]
  node_game_ops["Game detection and launch<br/>[game.py]"]
  node_game_config["Game configuration<br/>[game.py]"]
end

subgraph group_features["Localization and settings"]
  node_localization["Vietnamese localization download<br/>[downloader.py]"]
  node_font_tools["Font PAK tools<br/>[font_packer.py]"]
  node_performance["Performance settings<br/>[performance.py]"]
  node_presets["Graphics presets<br/>[presets_data.py]"]
end

subgraph group_updates["Launcher updates"]
  node_launcher_update["Launcher self-update<br/>[launcher_update.py]"]
  node_version["Version metadata<br/>[version.py]"]
end

node_user(("Launcher user"))
node_translation_source["Translation source"]
node_github_releases["GitHub releases"]

node_user -->|"uses"| node_ui
node_ui -->|"sends IPC"| node_shell
node_shell -->|"routes actions"| node_game_ops
node_shell -->|"downloads translation"| node_localization
node_shell -->|"routes settings"| node_performance
node_shell -->|"routes updates"| node_launcher_update
node_game_ops -.->|"manages settings"| node_game_config
node_game_ops -->|"uses downloads"| node_localization
node_game_ops -->|"uses font tools"| node_font_tools
node_font_tools -->|"fetches template"| node_localization
node_font_tools -->|"uses game paths"| node_game_ops
node_performance -->|"reads config"| node_game_config
node_performance -->|"loads presets"| node_presets
node_localization -->|"downloads from"| node_translation_source
node_launcher_update -->|"uses downloader"| node_localization
node_launcher_update -->|"checks releases"| node_github_releases
node_launcher_update -->|"checks version"| node_version
node_game_config -->|"supports Steam and Heroic"| node_game_ops
node_ui -->|"offers themes"| node_themes

click node_ui "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/frontend/app.js"
click node_themes "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/frontend/themes/themes.js"
click node_shell "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/launcher.py"
click node_game_ops "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/game.py"
click node_game_config "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/game.py"
click node_localization "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/downloader.py"
click node_font_tools "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/font_packer.py"
click node_performance "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/performance.py"
click node_presets "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/presets_data.py"
click node_launcher_update "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/launcher_update.py"
click node_version "https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/version.py"

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_themes,node_shell,node_user toneBlue
class node_game_ops,node_game_config toneAmber
class node_localization,node_font_tools,node_performance,node_presets toneMint
class node_launcher_update,node_version toneRose
class node_translation_source,node_github_releases toneIndigo
```

## Components

### Desktop interface

- [Launcher interface](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/frontend/app.js): `frontend/app.js`
- [Theme choices](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/frontend/themes/themes.js): `frontend/themes/themes.js`
- [GTK/WebKit shell](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/launcher.py): `launcher.py`

### Game management

- [Game detection and launch](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/game.py): `backend/game.py`
- [Game configuration](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/game.py): `backend/game.py`

### Localization and settings

- [Vietnamese localization download](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/downloader.py): `backend/downloader.py`
- [Font PAK tools](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/font_packer.py): `backend/font_packer.py`
- [Performance settings](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/performance.py): `backend/performance.py`
- [Graphics presets](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/presets_data.py): `backend/presets_data.py`

### Launcher updates

- [Launcher self-update](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/launcher_update.py): `backend/launcher_update.py`
- [Version metadata](https://github.com/jingjo07/wuwavh-linux-launcher/blob/main/backend/version.py): `backend/version.py`

### Other components

- **Launcher user**
- **Translation source**
- **GitHub releases**

## Connections

- Launcher user → Launcher interface: uses (evidence: `README.md`)
- Launcher interface → GTK/WebKit shell: sends IPC (evidence: `frontend/app.js`)
- GTK/WebKit shell → Game detection and launch: routes actions (evidence: `launcher.py`)
- GTK/WebKit shell → Vietnamese localization download: downloads translation (evidence: `launcher.py`)
- GTK/WebKit shell → Performance settings: routes settings (evidence: `launcher.py`)
- GTK/WebKit shell → Launcher self-update: routes updates (evidence: `launcher.py`)
- Game detection and launch → Game configuration: manages settings (evidence: `backend/game.py`)
- Game detection and launch → Vietnamese localization download: uses downloads (evidence: `backend/game.py`)
- Game detection and launch → Font PAK tools: uses font tools (evidence: `backend/game.py`)
- Font PAK tools → Vietnamese localization download: fetches template (evidence: `backend/font_packer.py`)
- Font PAK tools → Game detection and launch: uses game paths (evidence: `backend/font_packer.py`)
- Performance settings → Game configuration: reads config (evidence: `backend/performance.py`)
- Performance settings → Graphics presets: loads presets (evidence: `backend/performance.py`)
- Vietnamese localization download → Translation source: downloads from (evidence: `README.md`)
- Launcher self-update → Vietnamese localization download: uses downloader (evidence: `backend/launcher_update.py`)
- Launcher self-update → GitHub releases: checks releases (evidence: `backend/launcher_update.py`)
- Launcher self-update → Version metadata: checks version (evidence: `backend/launcher_update.py`)
- Game configuration → Game detection and launch: supports Steam and Heroic (evidence: `README.md`)
- Launcher interface → Theme choices: offers themes (evidence: `README.md`)
