# beyonddimension/steamtools architecture

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

- Interactive diagram: https://gitdiagram.com/beyonddimension/steamtools
- Repository: https://github.com/beyonddimension/steamtools

## Overview

Watt Toolkit is a cross-platform desktop game utility whose default plugins provide network acceleration, account switching, game-library management, and local authenticators. The visible UI exposes feature pages and settings; the accelerator plugin has a separate reverse-proxy process, certificate support, and script management. The README documents several capabilities whose implementation is not in the sampled excerpts, so those are represented by their exact enclosing plugin directories. Connections between UI and plugin services are not asserted where the excerpts do not show the wiring.

Main entry points: [`src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs`](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs) (Proxy process), [`src/BD.WTTS.Client.AppHost/Program.cs`](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.AppHost/Program.cs) (App startup), [`src/BD.WTTS.Client.Avalonia/UI/Views/Pages/MainView.axaml.cs`](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia/UI/Views/Pages/MainView.axaml.cs) (Main and settings UI), [`src/BD.WTTS.Client.Plugins.Accelerator/UI/Views/Pages/AcceleratorPage.axaml.cs`](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/UI/Views/Pages/AcceleratorPage.axaml.cs) (Accelerator UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client application"]
  node_app["Avalonia app<br/>[Program.cs]"]
  node_startup["App startup<br/>[Program.cs]"]
  node_mainui["Main and settings UI<br/>[MainView.axaml.cs]"]
  node_window["Window manager"]
end

subgraph group_accelerator["Network acceleration"]
  node_acceleratorui["Accelerator UI"]
  node_accelservice["Accelerator service"]
  node_proxyprocess["Proxy process<br/>[Program.cs]"]
  node_interception["Traffic interception<br/>[PacketIntercept]"]
  node_proxyhandlers["Proxy handlers<br/>[Middleware]"]
  node_certs["Certificate management"]
  node_scripts["Script management<br/>[ScriptManager.cs]"]
end

subgraph group_accounts["Accounts and library"]
  node_account_switch["Platform account switching"]
  node_authui["Authenticator UI"]
  node_authrepo[("Authenticator repository")]
  node_gamelibrary["Game library"]
  node_game_tools["Game tools"]
end

subgraph group_platform["Platform services"]
  node_platform_service["Platform services"]
  node_ipc["Subprocess IPC"]
end

node_user(("Toolkit user"))
node_external_sites(("Game websites"))
node_steam(("Steam"))

node_user -->|"uses features"| node_mainui
node_mainui -.->|"opens"| node_acceleratorui
node_acceleratorui -.->|"configures"| node_accelservice
node_accelservice -.->|"starts acceleration"| node_proxyprocess
node_proxyprocess -->|"intercepts traffic"| node_interception
node_proxyprocess -->|"configures"| node_certs
node_proxyprocess -->|"configures"| node_proxyhandlers
node_proxyhandlers -->|"forwards requests"| node_external_sites
node_proxyprocess -.->|"loads scripts"| node_scripts
node_user -->|"switches accounts"| node_account_switch
node_user -->|"manages games"| node_gamelibrary
node_user -->|"manages tokens"| node_authui
node_authui -.->|"reads and writes"| node_authrepo
node_user -->|"uses game tools"| node_game_tools
node_steam -.->|"provides game data"| node_gamelibrary
node_app -.->|"initializes"| node_startup
node_startup -.->|"uses subprocess IPC"| node_ipc
node_platform_service -->|"obtains remote service"| node_ipc

click node_app "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia.App/Program.cs"
click node_startup "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.AppHost/Program.cs"
click node_mainui "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia/UI/Views/Pages/MainView.axaml.cs"
click node_window "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia/Services.Implementation/UI/Views/Windows/AvaloniaWindowManagerImpl.cs"
click node_acceleratorui "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/UI/Views/Pages/AcceleratorPage.axaml.cs"
click node_accelservice "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/BackendAcceleratorServiceImpl.cs"
click node_proxyprocess "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs"
click node_interception "https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/PacketIntercept"
click node_proxyhandlers "https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/HttpServer/Middleware"
click node_certs "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/Certificate/CertificateManagerImpl.cs"
click node_scripts "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/ScriptManager.cs"
click node_account_switch "https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.GameAccount"
click node_authui "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Authenticator/UI/ViewModels/AuthenticatorHomePageViewModel.cs"
click node_authrepo "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Authenticator/Repositories/AccountPlatformAuthenticatorRepository.cs"
click node_gamelibrary "https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.GameList"
click node_game_tools "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.SteamIdleCard/UI/ViewModels/IdleCardPageViewModel.cs"
click node_platform_service "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client/Services/Platform/IPlatformService.cs"
click node_ipc "https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.IPC/Services/IPCSubProcessService.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_app,node_startup,node_mainui,node_window,node_user toneBlue
class node_acceleratorui,node_accelservice,node_proxyprocess,node_interception,node_proxyhandlers,node_certs,node_scripts toneAmber
class node_account_switch,node_authui,node_authrepo,node_gamelibrary,node_game_tools toneMint
class node_platform_service,node_ipc toneRose
class node_external_sites,node_steam toneIndigo
```

## Components

### Client application

- [Avalonia app](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia.App/Program.cs): `src/BD.WTTS.Client.Avalonia.App/Program.cs`
- [App startup](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.AppHost/Program.cs): `src/BD.WTTS.Client.AppHost/Program.cs`
- [Main and settings UI](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia/UI/Views/Pages/MainView.axaml.cs): `src/BD.WTTS.Client.Avalonia/UI/Views/Pages/MainView.axaml.cs`
- [Window manager](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Avalonia/Services.Implementation/UI/Views/Windows/AvaloniaWindowManagerImpl.cs): `src/BD.WTTS.Client.Avalonia/Services.Implementation/UI/Views/Windows/AvaloniaWindowManagerImpl.cs`

### Network acceleration

- [Accelerator UI](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/UI/Views/Pages/AcceleratorPage.axaml.cs): `src/BD.WTTS.Client.Plugins.Accelerator/UI/Views/Pages/AcceleratorPage.axaml.cs`
- [Accelerator service](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/BackendAcceleratorServiceImpl.cs): `src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/BackendAcceleratorServiceImpl.cs`
- [Proxy process](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs): `src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs`
- [Traffic interception](https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/PacketIntercept): `src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/PacketIntercept`
- [Proxy handlers](https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/HttpServer/Middleware): `src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/HttpServer/Middleware`
- [Certificate management](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/Certificate/CertificateManagerImpl.cs): `src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Services.Implementation/Certificate/CertificateManagerImpl.cs`
- [Script management](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/ScriptManager.cs): `src/BD.WTTS.Client.Plugins.Accelerator/Services.Implementation/ScriptManager.cs`

### Accounts and library

- [Platform account switching](https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.GameAccount): `src/BD.WTTS.Client.Plugins.GameAccount`
- [Authenticator UI](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Authenticator/UI/ViewModels/AuthenticatorHomePageViewModel.cs): `src/BD.WTTS.Client.Plugins.Authenticator/UI/ViewModels/AuthenticatorHomePageViewModel.cs`
- [Authenticator repository](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.Authenticator/Repositories/AccountPlatformAuthenticatorRepository.cs): `src/BD.WTTS.Client.Plugins.Authenticator/Repositories/AccountPlatformAuthenticatorRepository.cs`
- [Game library](https://github.com/beyonddimension/steamtools/tree/develop/src/BD.WTTS.Client.Plugins.GameList): `src/BD.WTTS.Client.Plugins.GameList`
- [Game tools](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.Plugins.SteamIdleCard/UI/ViewModels/IdleCardPageViewModel.cs): `src/BD.WTTS.Client.Plugins.SteamIdleCard/UI/ViewModels/IdleCardPageViewModel.cs`

### Platform services

- [Platform services](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client/Services/Platform/IPlatformService.cs): `src/BD.WTTS.Client/Services/Platform/IPlatformService.cs`
- [Subprocess IPC](https://github.com/beyonddimension/steamtools/blob/develop/src/BD.WTTS.Client.IPC/Services/IPCSubProcessService.cs): `src/BD.WTTS.Client.IPC/Services/IPCSubProcessService.cs`

### Other components

- **Toolkit user**
- **Game websites**
- **Steam**

## Connections

- Toolkit user → Main and settings UI: uses features (evidence: `README.md`)
- Main and settings UI → Accelerator UI: opens
- Accelerator UI → Accelerator service: configures
- Accelerator service → Proxy process: starts acceleration
- Proxy process → Traffic interception: intercepts traffic
- Proxy process → Certificate management: configures (evidence: `src/BD.WTTS.Client.Plugins.Accelerator.ReverseProxy/Program.cs`)
- Proxy process → Proxy handlers: configures
- Proxy handlers → Game websites: forwards requests (evidence: `README.md`)
- Proxy process → Script management: loads scripts
- Toolkit user → Platform account switching: switches accounts (evidence: `README.md`)
- Toolkit user → Game library: manages games (evidence: `README.md`)
- Toolkit user → Authenticator UI: manages tokens (evidence: `README.md`)
- Authenticator UI → Authenticator repository: reads and writes
- Toolkit user → Game tools: uses game tools (evidence: `README.md`)
- Steam → Game library: provides game data
- Avalonia app → App startup: initializes
- App startup → Subprocess IPC: uses subprocess IPC
- Platform services → Subprocess IPC: obtains remote service (evidence: `src/BD.WTTS.Client/Services/Platform/IPlatformService.cs`)
