# alhroobix/xenia-dashboard architecture

> Architecture diagram of the GitHub repository alhroobix/xenia-dashboard, 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/alhroobix/xenia-dashboard
- Repository: https://github.com/alhroobix/xenia-dashboard

## Overview

Xenia Dashboard is an Electron frontend for managing and launching Xenia Xbox 360 games. The user configures emulator and library paths, scans a collection, enriches titles with artwork and compatibility data, then launches and manages games, settings, patches, and profiles. The renderer reaches desktop capabilities through the preload IPC bridge to the main process; auxiliary native and Python tools handle controller events, Xbox profile/achievement data, and TOML patch/config operations. README features document several capabilities whose internal implementation is not fully visible in the excerpts, so those links are shown only where supported.

Main entry points: [`source/Xenia-dashboard/main.js`](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js) (Electron services), [`source/Xenia-dashboard/core.js`](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/core.js) (Dashboard actions), [`source/Xenia-dashboard/preload.js`](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/preload.js) (Preload API), [`source/Xenia-dashboard/layouts/NXE-2008/dashboard.html`](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/layouts/NXE-2008/dashboard.html) (Dashboard views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_renderer["Dashboard actions<br/>[core.js]"]
  node_views["Dashboard views<br/>[dashboard.html]"]
end

subgraph group_desktop["Desktop Services"]
  node_bridge["Preload API<br/>[preload.js]"]
  node_main["Electron services<br/>[main.js]"]
  node_preferences[("Preferences store<br/>[main.js]")]
  node_library["Game library scan<br/>[main.js]"]
  node_metadata["Metadata and artwork<br/>[main.js]"]
  node_compat["Compatibility lookup<br/>[main.js]"]
  node_emulator["Xenia launch and updates<br/>[main.js]"]
  node_configuration["Per-game configuration<br/>[patch_manager.py]"]
  node_patches["Patch manager<br/>[patch_manager.py]"]
end

subgraph group_tools["Game Tools"]
  node_accounts["Profiles and achievements<br/>[xenia_toolbox.cpp]"]
  node_controller["Controller input"]
end

subgraph group_assets["UI Resources"]
  node_theme["Themes and styles<br/>[style.css]"]
  node_data["Locales and title data"]
end

node_player(("Player"))
node_xenia["Xenia emulator"]
node_steamgriddb["SteamGridDB"]
node_compatservice["Xenia compatibility tracker"]
node_github["GitHub releases and patches"]
node_gamefiles[("Game collection")]

node_player -.->|"navigates"| node_renderer
node_renderer -->|"invokes API"| node_bridge
node_bridge -->|"IPC requests"| node_main
node_main -->|"reads and writes"| node_preferences
node_main -.->|"handles scans"| node_library
node_library -.->|"scans"| node_gamefiles
node_main -->|"fetches artwork"| node_metadata
node_metadata -->|"queries assets"| node_steamgriddb
node_main -.->|"looks up status"| node_compat
node_compat -.->|"queries tracker"| node_compatservice
node_renderer -.->|"displays"| node_views
node_renderer -.->|"applies theme"| node_theme
node_renderer -.->|"uses locales"| node_data
node_main -.->|"launches and updates"| node_emulator
node_emulator -.->|"starts"| node_xenia
node_main -.->|"manages config"| node_configuration
node_main -.->|"manages patches"| node_patches
node_renderer -->|"requests achievements"| node_accounts
node_renderer -.->|"uses navigation input"| node_controller
node_main -->|"checks releases"| node_github

click node_renderer "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/core.js"
click node_views "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/layouts/NXE-2008/dashboard.html"
click node_theme "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/themes/NXE-2008/style.css"
click node_data "https://github.com/alhroobix/xenia-dashboard/tree/main/source/Xenia-dashboard/data"
click node_bridge "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/preload.js"
click node_main "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_preferences "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_library "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_metadata "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_compat "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_emulator "https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js"
click node_configuration "https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/patch_manager/patch_manager.py"
click node_patches "https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/patch_manager/patch_manager.py"
click node_accounts "https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/Xenia_toolbox/xenia_toolbox.cpp"
click node_controller "https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/Controller/controller_linux.cpp"

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_renderer,node_views toneBlue
class node_bridge,node_main,node_preferences,node_library,node_metadata,node_compat,node_emulator,node_configuration,node_patches,node_gamefiles toneAmber
class node_accounts,node_controller toneMint
class node_theme,node_data toneRose
class node_player,node_xenia,node_steamgriddb,node_compatservice,node_github toneIndigo
```

## Components

### Dashboard UI

- [Dashboard actions](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/core.js): `source/Xenia-dashboard/core.js`
- [Dashboard views](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/layouts/NXE-2008/dashboard.html): `source/Xenia-dashboard/layouts/NXE-2008/dashboard.html`

### Desktop Services

- [Preload API](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/preload.js): `source/Xenia-dashboard/preload.js`
- [Electron services](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Preferences store](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Game library scan](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Metadata and artwork](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Compatibility lookup](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Xenia launch and updates](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/main.js): `source/Xenia-dashboard/main.js`
- [Per-game configuration](https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/patch_manager/patch_manager.py): `source/bin/patch_manager/patch_manager.py`
- [Patch manager](https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/patch_manager/patch_manager.py): `source/bin/patch_manager/patch_manager.py`

### Game Tools

- [Profiles and achievements](https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/Xenia_toolbox/xenia_toolbox.cpp): `source/bin/Xenia_toolbox/xenia_toolbox.cpp`
- [Controller input](https://github.com/alhroobix/xenia-dashboard/blob/main/source/bin/Controller/controller_linux.cpp): `source/bin/Controller/controller_linux.cpp`

### UI Resources

- [Themes and styles](https://github.com/alhroobix/xenia-dashboard/blob/main/source/Xenia-dashboard/themes/NXE-2008/style.css): `source/Xenia-dashboard/themes/NXE-2008/style.css`
- [Locales and title data](https://github.com/alhroobix/xenia-dashboard/tree/main/source/Xenia-dashboard/data): `source/Xenia-dashboard/data`

### Other components

- **Player**
- **Xenia emulator**
- **SteamGridDB**
- **Xenia compatibility tracker**
- **GitHub releases and patches**
- **Game collection**

## Connections

- Player → Dashboard actions: navigates (evidence: `README.md`)
- Dashboard actions → Preload API: invokes API (evidence: `source/Xenia-dashboard/core.js`)
- Preload API → Electron services: IPC requests (evidence: `source/Xenia-dashboard/preload.js`)
- Electron services → Preferences store: reads and writes (evidence: `source/Xenia-dashboard/main.js`)
- Electron services → Game library scan: handles scans (evidence: `README.md`)
- Game library scan → Game collection: scans (evidence: `README.md`)
- Electron services → Metadata and artwork: fetches artwork (evidence: `source/Xenia-dashboard/main.js`)
- Metadata and artwork → SteamGridDB: queries assets (evidence: `source/Xenia-dashboard/main.js`)
- Electron services → Compatibility lookup: looks up status (evidence: `README.md`)
- Compatibility lookup → Xenia compatibility tracker: queries tracker (evidence: `README.md`)
- Dashboard actions → Dashboard views: displays (evidence: `README.md`)
- Dashboard actions → Themes and styles: applies theme (evidence: `README.md`)
- Dashboard actions → Locales and title data: uses locales (evidence: `README.md`)
- Electron services → Xenia launch and updates: launches and updates (evidence: `README.md`)
- Xenia launch and updates → Xenia emulator: starts (evidence: `README.md`)
- Electron services → Per-game configuration: manages config (evidence: `README.md`)
- Electron services → Patch manager: manages patches (evidence: `README.md`)
- Dashboard actions → Profiles and achievements: requests achievements (evidence: `source/Xenia-dashboard/core.js`)
- Dashboard actions → Controller input: uses navigation input (evidence: `README.md`)
- Electron services → GitHub releases and patches: checks releases (evidence: `source/Xenia-dashboard/main.js`)
