# metruu1337/hosas-bridge architecture

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

- Interactive diagram: https://gitdiagram.com/metruu1337/hosas-bridge
- Repository: https://github.com/metruu1337/hosas-bridge

## Overview

HOSAS Bridge is a Windows app for identifying physical controllers, configuring profiles and routing their input to a persistent virtual joystick, with optional device hiding. The main workflow is user setup and mapping through the app, profile activation, live input processing, and virtual-controller output. The graph also preserves setup, diagnostics, settings, and tuning capabilities documented in the README. Relationships are limited to the shown excerpts, SOURCE INDEX references, and README; some runtime wiring is therefore omitted.

Main entry points: [`src/HOSASBridge.App/ViewModels/MainViewModel.cs`](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/MainViewModel.cs) (Main controls), [`src/HOSASBridge.App/App.xaml.cs`](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/App.xaml.cs) (App startup), [`src/HOSASBridge.App/Services/ProfileSession.cs`](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/Services/ProfileSession.cs) (Profile session), [`src/HOSASBridge.Infrastructure/BridgeRuntime.cs`](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Infrastructure/BridgeRuntime.cs) (Bridge runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_app["App startup<br/>[App.xaml.cs]"]
  node_mainvm["Main controls<br/>[MainViewModel.cs]"]
  node_devicevm["Device setup UI"]
  node_profilevm["Profile editor"]
  node_preview["Axis preview"]
  node_diagvm["Diagnostics UI"]
end

subgraph group_coord["Runtime coordination"]
  node_session["Profile session<br/>[ProfileSession.cs]"]
  node_runtime["Bridge runtime<br/>[BridgeRuntime.cs]"]
  node_settings["User settings<br/>[UserSettings.cs]"]
  node_logging["Diagnostic log<br/>[DiagnosticLog.cs]"]
end

subgraph group_core["Input processing"]
  node_input["Input pipeline<br/>[InputPipeline.cs]"]
  node_transform["Axis transforms<br/>[AxisTransformer.cs]"]
  node_modes["Mode controller<br/>[ModeController.cs]"]
  node_identity["Device identity"]
end

subgraph group_profiles["Profiles and setup"]
  node_repo["Profile repository"]
  node_validator["Profile validation"]
  node_presets["Preset catalog<br/>[PresetCatalog.cs]"]
  node_defaults["Profile defaults<br/>[ProfileDefaults.cs]"]
  node_setup["Setup operations<br/>[SetupOperations.cs]"]
end

subgraph group_integration["Device integrations"]
  node_direct["DirectInput provider"]
  node_xinput["XInput provider<br/>[XInputProvider.cs]"]
  node_vjoy["vJoy adapter<br/>[VJoyAdapter.cs]"]
  node_hidhide["Device hiding<br/>[HidHideService.cs]"]
end

node_user(("User"))
node_hidservice["HidHide CLI"]
node_vjoydriver["vJoy driver"]

node_user -->|"configures"| node_mainvm
node_app -->|"creates"| node_mainvm
node_mainvm -->|"uses"| node_session
node_mainvm -->|"creates"| node_devicevm
node_mainvm -->|"creates"| node_profilevm
node_mainvm -->|"creates"| node_diagvm
node_session -->|"saves through"| node_repo
node_session -->|"validates with"| node_validator
node_session -->|"activates profile"| node_runtime
node_profilevm -->|"uses"| node_presets
node_profilevm -->|"creates"| node_preview
node_preview -->|"reads snapshots"| node_runtime
node_preview -->|"previews with"| node_transform
node_runtime -->|"processes through"| node_input
node_runtime -->|"resolves roles"| node_identity
node_input -->|"transforms axes"| node_transform
node_input -->|"applies modes"| node_modes
node_app -->|"initializes"| node_direct
node_app -->|"initializes"| node_xinput
node_app -->|"initializes"| node_vjoy
node_mainvm -->|"uses"| node_hidhide
node_devicevm -->|"invokes"| node_setup
node_devicevm -->|"uses"| node_presets
node_hidhide -->|"runs CLI"| node_hidservice
node_setup -->|"configures"| node_vjoydriver
node_presets -->|"uses"| node_repo
node_presets -->|"uses"| node_defaults
node_repo -->|"validates profiles"| node_validator
node_diagvm -->|"uses"| node_logging
node_diagvm -->|"reads settings"| node_settings
node_app -->|"creates"| node_logging

click node_app "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/App.xaml.cs"
click node_mainvm "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/MainViewModel.cs"
click node_devicevm "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/DevicesViewModel.cs"
click node_profilevm "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/ProfileViewModel.cs"
click node_preview "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/AxisPreviewViewModel.cs"
click node_diagvm "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/DiagnosticsViewModel.cs"
click node_session "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/Services/ProfileSession.cs"
click node_runtime "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Infrastructure/BridgeRuntime.cs"
click node_settings "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Infrastructure/UserSettings.cs"
click node_logging "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Diagnostics/DiagnosticLog.cs"
click node_input "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/InputPipeline.cs"
click node_transform "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/AxisTransformer.cs"
click node_modes "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/ModeController.cs"
click node_identity "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/DeviceIdentityResolver.cs"
click node_direct "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Input.DirectInput/DirectInputProvider.cs"
click node_xinput "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Input.DirectInput/XInputProvider.cs"
click node_vjoy "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Output.VJoy/VJoyAdapter.cs"
click node_hidhide "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.DeviceHiding/HidHideService.cs"
click node_repo "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileRepository.cs"
click node_validator "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileValidator.cs"
click node_presets "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/PresetCatalog.cs"
click node_defaults "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileDefaults.cs"
click node_setup "https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Setup/SetupOperations.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_mainvm,node_devicevm,node_profilevm,node_preview,node_diagvm,node_user toneBlue
class node_session,node_runtime,node_settings,node_logging toneAmber
class node_input,node_transform,node_modes,node_identity toneMint
class node_repo,node_validator,node_presets,node_defaults,node_setup toneRose
class node_direct,node_xinput,node_vjoy,node_hidhide,node_hidservice,node_vjoydriver toneIndigo
```

## Components

### Desktop app

- [App startup](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/App.xaml.cs): `src/HOSASBridge.App/App.xaml.cs`
- [Main controls](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/MainViewModel.cs): `src/HOSASBridge.App/ViewModels/MainViewModel.cs`
- [Device setup UI](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/DevicesViewModel.cs): `src/HOSASBridge.App/ViewModels/DevicesViewModel.cs`
- [Profile editor](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/ProfileViewModel.cs): `src/HOSASBridge.App/ViewModels/ProfileViewModel.cs`
- [Axis preview](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/AxisPreviewViewModel.cs): `src/HOSASBridge.App/ViewModels/AxisPreviewViewModel.cs`
- [Diagnostics UI](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/ViewModels/DiagnosticsViewModel.cs): `src/HOSASBridge.App/ViewModels/DiagnosticsViewModel.cs`

### Runtime coordination

- [Profile session](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.App/Services/ProfileSession.cs): `src/HOSASBridge.App/Services/ProfileSession.cs`
- [Bridge runtime](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Infrastructure/BridgeRuntime.cs): `src/HOSASBridge.Infrastructure/BridgeRuntime.cs`
- [User settings](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Infrastructure/UserSettings.cs): `src/HOSASBridge.Infrastructure/UserSettings.cs`
- [Diagnostic log](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Diagnostics/DiagnosticLog.cs): `src/HOSASBridge.Diagnostics/DiagnosticLog.cs`

### Input processing

- [Input pipeline](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/InputPipeline.cs): `src/HOSASBridge.Core/InputPipeline.cs`
- [Axis transforms](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/AxisTransformer.cs): `src/HOSASBridge.Core/AxisTransformer.cs`
- [Mode controller](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/ModeController.cs): `src/HOSASBridge.Core/ModeController.cs`
- [Device identity](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Core/DeviceIdentityResolver.cs): `src/HOSASBridge.Core/DeviceIdentityResolver.cs`

### Profiles and setup

- [Profile repository](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileRepository.cs): `src/HOSASBridge.Profiles/ProfileRepository.cs`
- [Profile validation](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileValidator.cs): `src/HOSASBridge.Profiles/ProfileValidator.cs`
- [Preset catalog](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/PresetCatalog.cs): `src/HOSASBridge.Profiles/PresetCatalog.cs`
- [Profile defaults](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Profiles/ProfileDefaults.cs): `src/HOSASBridge.Profiles/ProfileDefaults.cs`
- [Setup operations](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Setup/SetupOperations.cs): `src/HOSASBridge.Setup/SetupOperations.cs`

### Device integrations

- [DirectInput provider](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Input.DirectInput/DirectInputProvider.cs): `src/HOSASBridge.Input.DirectInput/DirectInputProvider.cs`
- [XInput provider](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Input.DirectInput/XInputProvider.cs): `src/HOSASBridge.Input.DirectInput/XInputProvider.cs`
- [vJoy adapter](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.Output.VJoy/VJoyAdapter.cs): `src/HOSASBridge.Output.VJoy/VJoyAdapter.cs`
- [Device hiding](https://github.com/metruu1337/hosas-bridge/blob/main/src/HOSASBridge.DeviceHiding/HidHideService.cs): `src/HOSASBridge.DeviceHiding/HidHideService.cs`

### Other components

- **User**
- **HidHide CLI**
- **vJoy driver**

## Connections

- User → Main controls: configures (evidence: `README.md`)
- App startup → Main controls: creates (evidence: `src/HOSASBridge.App/App.xaml.cs`)
- Main controls → Profile session: uses (evidence: `src/HOSASBridge.App/ViewModels/MainViewModel.cs`)
- Main controls → Device setup UI: creates (evidence: `src/HOSASBridge.App/ViewModels/MainViewModel.cs`)
- Main controls → Profile editor: creates (evidence: `src/HOSASBridge.App/ViewModels/MainViewModel.cs`)
- Main controls → Diagnostics UI: creates (evidence: `src/HOSASBridge.App/ViewModels/MainViewModel.cs`)
- Profile session → Profile repository: saves through (evidence: `src/HOSASBridge.App/Services/ProfileSession.cs`)
- Profile session → Profile validation: validates with (evidence: `src/HOSASBridge.App/Services/ProfileSession.cs`)
- Profile session → Bridge runtime: activates profile (evidence: `src/HOSASBridge.App/Services/ProfileSession.cs`)
- Profile editor → Preset catalog: uses (evidence: `src/HOSASBridge.App/ViewModels/ProfileViewModel.cs`)
- Profile editor → Axis preview: creates (evidence: `src/HOSASBridge.App/ViewModels/ProfileViewModel.cs`)
- Axis preview → Bridge runtime: reads snapshots (evidence: `src/HOSASBridge.App/ViewModels/AxisPreviewViewModel.cs`)
- Axis preview → Axis transforms: previews with (evidence: `src/HOSASBridge.App/ViewModels/AxisPreviewViewModel.cs`)
- Bridge runtime → Input pipeline: processes through (evidence: `src/HOSASBridge.Infrastructure/BridgeRuntime.cs`)
- Bridge runtime → Device identity: resolves roles (evidence: `src/HOSASBridge.Infrastructure/BridgeRuntime.cs`)
- Input pipeline → Axis transforms: transforms axes (evidence: `src/HOSASBridge.Core/InputPipeline.cs`)
- Input pipeline → Mode controller: applies modes (evidence: `src/HOSASBridge.Core/InputPipeline.cs`)
- App startup → DirectInput provider: initializes (evidence: `src/HOSASBridge.App/App.xaml.cs`)
- App startup → XInput provider: initializes (evidence: `src/HOSASBridge.App/App.xaml.cs`)
- App startup → vJoy adapter: initializes (evidence: `src/HOSASBridge.App/App.xaml.cs`)
- Main controls → Device hiding: uses (evidence: `src/HOSASBridge.App/ViewModels/MainViewModel.cs`)
- Device setup UI → Setup operations: invokes (evidence: `src/HOSASBridge.App/ViewModels/DevicesViewModel.cs`)
- Device setup UI → Preset catalog: uses (evidence: `src/HOSASBridge.App/ViewModels/DevicesViewModel.cs`)
- Device hiding → HidHide CLI: runs CLI (evidence: `src/HOSASBridge.DeviceHiding/HidHideService.cs`)
- Setup operations → vJoy driver: configures (evidence: `src/HOSASBridge.Setup/SetupOperations.cs`)
- Preset catalog → Profile repository: uses (evidence: `src/HOSASBridge.Profiles/PresetCatalog.cs`)
- Preset catalog → Profile defaults: uses (evidence: `src/HOSASBridge.Profiles/PresetCatalog.cs`)
- Profile repository → Profile validation: validates profiles (evidence: `src/HOSASBridge.Profiles/ProfileRepository.cs`)
- Diagnostics UI → Diagnostic log: uses (evidence: `src/HOSASBridge.App/ViewModels/DiagnosticsViewModel.cs`)
- Diagnostics UI → User settings: reads settings (evidence: `src/HOSASBridge.App/ViewModels/DiagnosticsViewModel.cs`)
- App startup → Diagnostic log: creates (evidence: `src/HOSASBridge.App/App.xaml.cs`)
