# sequal32/yourcontrols architecture

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

- Interactive diagram: https://gitdiagram.com/sequal32/yourcontrols
- Repository: https://github.com/sequal32/yourcontrols

## Overview

YourControls is a shared-cockpit companion for Microsoft Flight Simulator. A user configures or joins/hosts a session through the desktop app; the program coordinates networking, simulator access, and transfer of aircraft state, while control and observer status are managed alongside synchronization. The repository also contains rendezvous/hosting server services and a browser-based emulator UI. Edges are limited to relationships shown in excerpts, the SOURCE INDEX, or the README; unsampled UI and integration wiring is not inferred.

Main entry points: [`src/yourcontrols/src/program.rs`](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program.rs) (Program loop), [`src/yourcontrols/src/program/network.rs`](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/network.rs) (Network controller), [`src/yourcontrols/src/definitions.rs`](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/definitions.rs) (Aircraft definitions), [`src/yourcontrols/src/program/simconnect.rs`](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/simconnect.rs) (Simulator connector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop client"]
  node_entry["Client entry<br/>[main.rs]"]
  node_settings["Config and CLI<br/>[simconfig.rs]"]
  node_app["Desktop app<br/>[app.rs]"]
  node_loop["App controller<br/>[app_loop.rs]"]
  node_program["Program loop<br/>[program.rs]"]
end

subgraph group_runtime["Flight runtime"]
  node_sync["State synchronization<br/>[sync.rs]"]
  node_transfer["Sync transfer<br/>[transfer.rs]"]
  node_definitions["Aircraft definitions<br/>[definitions.rs]"]
  node_simconnect["Simulator connector<br/>[simconnect.rs]"]
  node_varreader["Variable reader<br/>[varreader.rs]"]
  node_emulator["Emulator runtime"]
end

subgraph group_network["Networking"]
  node_network_ctrl["Network controller<br/>[network.rs]"]
  node_clientmanager["Control roles<br/>[clientmanager.rs]"]
  node_netclient["Network client<br/>[client.rs]"]
  node_netserver["Network server<br/>[server.rs]"]
  node_messages["Network messages<br/>[messages.rs]"]
end

subgraph group_server["Session services"]
  node_server_entry["Server entry<br/>[main.rs]"]
  node_rendezvous["Rendezvous service<br/>[rendezvous.rs]"]
  node_sessions[("Session registry<br/>[sessions.rs]")]
  node_hoster["Hoster service<br/>[hoster.rs]"]
  node_servers[("Server registry<br/>[servers.rs]")]
end

subgraph group_web["Web interface"]
  node_browser_emulator["Browser emulator<br/>[emulator.js]"]
  node_browser_main["Browser interface<br/>[main.js]"]
end

node_user(("Pilot"))
node_simulator["Flight simulator"]
node_pilots(("Other pilots"))

node_user -->|"starts"| node_entry
node_entry -->|"creates"| node_program
node_program -->|"loads"| node_settings
node_program -->|"creates"| node_app
node_program -->|"polls"| node_loop
node_user -->|"uses"| node_app
node_loop -->|"handles messages"| node_app
node_loop -->|"starts client"| node_netclient
node_loop -->|"starts server"| node_netserver
node_program -->|"polls"| node_network_ctrl
node_network_ctrl -->|"updates roles"| node_clientmanager
node_network_ctrl -->|"applies received data"| node_definitions
node_network_ctrl -->|"processes events"| node_netclient
node_netclient -->|"uses payloads"| node_messages
node_program -->|"ticks"| node_sync
node_sync -->|"coordinates with"| node_network_ctrl
node_sync -->|"coordinates with"| node_simconnect
node_sync -->|"uses"| node_definitions
node_definitions -->|"uses"| node_transfer
node_definitions -->|"uses"| node_simconnect
node_program -->|"polls"| node_simconnect
node_simconnect -.->|"connects to"| node_simulator
node_program -->|"ticks"| node_emulator
node_emulator -->|"reads and updates"| node_definitions
node_emulator -->|"sets simulator values"| node_simconnect
node_browser_main -.->|"coordinates"| node_browser_emulator
node_server_entry -->|"starts"| node_hoster
node_server_entry -->|"runs"| node_rendezvous
node_rendezvous -->|"uses"| node_sessions
node_rendezvous -->|"uses"| node_servers
node_hoster -->|"uses"| node_servers
node_pilots -.->|"connects through"| node_netclient

click node_entry "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/main.rs"
click node_settings "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/simconfig.rs"
click node_app "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/app.rs"
click node_loop "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/app_loop.rs"
click node_program "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program.rs"
click node_network_ctrl "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/network.rs"
click node_clientmanager "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/clientmanager.rs"
click node_netclient "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/client.rs"
click node_netserver "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/server.rs"
click node_messages "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/messages.rs"
click node_sync "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/sync.rs"
click node_transfer "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/sync/transfer.rs"
click node_definitions "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/definitions.rs"
click node_simconnect "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/simconnect.rs"
click node_varreader "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/varreader.rs"
click node_emulator "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/emulator_runtime.rs"
click node_browser_emulator "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/web/emulator.js"
click node_browser_main "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/web/main.js"
click node_server_entry "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/main.rs"
click node_rendezvous "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/rendezvous.rs"
click node_sessions "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/sessions.rs"
click node_hoster "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/hoster.rs"
click node_servers "https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/servers.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_settings,node_app,node_loop,node_program toneBlue
class node_sync,node_transfer,node_definitions,node_simconnect,node_varreader,node_emulator toneAmber
class node_network_ctrl,node_clientmanager,node_netclient,node_netserver,node_messages toneMint
class node_server_entry,node_rendezvous,node_sessions,node_hoster,node_servers toneRose
class node_browser_emulator,node_browser_main,node_user,node_simulator,node_pilots toneIndigo
```

## Components

### Desktop client

- [Client entry](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/main.rs): `src/yourcontrols/src/main.rs`
- [Config and CLI](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/simconfig.rs): `src/yourcontrols/src/simconfig.rs`
- [Desktop app](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/app.rs): `src/yourcontrols/src/app.rs`
- [App controller](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/app_loop.rs): `src/yourcontrols/src/program/app_loop.rs`
- [Program loop](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program.rs): `src/yourcontrols/src/program.rs`

### Flight runtime

- [State synchronization](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/sync.rs): `src/yourcontrols/src/program/sync.rs`
- [Sync transfer](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/sync/transfer.rs): `src/yourcontrols/src/sync/transfer.rs`
- [Aircraft definitions](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/definitions.rs): `src/yourcontrols/src/definitions.rs`
- [Simulator connector](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/simconnect.rs): `src/yourcontrols/src/program/simconnect.rs`
- [Variable reader](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/varreader.rs): `src/yourcontrols/src/varreader.rs`
- [Emulator runtime](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/emulator_runtime.rs): `src/yourcontrols/src/program/emulator_runtime.rs`

### Networking

- [Network controller](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/program/network.rs): `src/yourcontrols/src/program/network.rs`
- [Control roles](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/src/clientmanager.rs): `src/yourcontrols/src/clientmanager.rs`
- [Network client](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/client.rs): `src/yourcontrols-net/src/client.rs`
- [Network server](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/server.rs): `src/yourcontrols-net/src/server.rs`
- [Network messages](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-net/src/messages.rs): `src/yourcontrols-net/src/messages.rs`

### Session services

- [Server entry](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/main.rs): `src/yourcontrols-server/src/main.rs`
- [Rendezvous service](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/rendezvous.rs): `src/yourcontrols-server/src/rendezvous.rs`
- [Session registry](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/sessions.rs): `src/yourcontrols-server/src/sessions.rs`
- [Hoster service](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/hoster.rs): `src/yourcontrols-server/src/hoster.rs`
- [Server registry](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols-server/src/servers.rs): `src/yourcontrols-server/src/servers.rs`

### Web interface

- [Browser emulator](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/web/emulator.js): `src/yourcontrols/web/emulator.js`
- [Browser interface](https://github.com/sequal32/yourcontrols/blob/master/src/yourcontrols/web/main.js): `src/yourcontrols/web/main.js`

### Other components

- **Pilot**
- **Flight simulator**
- **Other pilots**

## Connections

- Pilot → Client entry: starts
- Client entry → Program loop: creates (evidence: `src/yourcontrols/src/main.rs`)
- Program loop → Config and CLI: loads (evidence: `src/yourcontrols/src/program.rs`)
- Program loop → Desktop app: creates (evidence: `src/yourcontrols/src/program.rs`)
- Program loop → App controller: polls (evidence: `src/yourcontrols/src/program.rs`)
- Pilot → Desktop app: uses (evidence: `src/yourcontrols/src/app.rs`)
- App controller → Desktop app: handles messages (evidence: `src/yourcontrols/src/program/app_loop.rs`)
- App controller → Network client: starts client (evidence: `src/yourcontrols/src/program/app_loop.rs`)
- App controller → Network server: starts server (evidence: `src/yourcontrols/src/program/app_loop.rs`)
- Program loop → Network controller: polls (evidence: `src/yourcontrols/src/program.rs`)
- Network controller → Control roles: updates roles (evidence: `src/yourcontrols/src/program/network.rs`)
- Network controller → Aircraft definitions: applies received data (evidence: `src/yourcontrols/src/program/network.rs`)
- Network controller → Network client: processes events (evidence: `src/yourcontrols/src/program/network.rs`)
- Network client → Network messages: uses payloads
- Program loop → State synchronization: ticks (evidence: `src/yourcontrols/src/program.rs`)
- State synchronization → Network controller: coordinates with (evidence: `src/yourcontrols/src/program/sync.rs`)
- State synchronization → Simulator connector: coordinates with (evidence: `src/yourcontrols/src/program/sync.rs`)
- State synchronization → Aircraft definitions: uses (evidence: `src/yourcontrols/src/program/sync.rs`)
- Aircraft definitions → Sync transfer: uses
- Aircraft definitions → Simulator connector: uses (evidence: `src/yourcontrols/src/definitions.rs`)
- Program loop → Simulator connector: polls (evidence: `src/yourcontrols/src/program.rs`)
- Simulator connector → Flight simulator: connects to
- Program loop → Emulator runtime: ticks (evidence: `src/yourcontrols/src/program.rs`)
- Emulator runtime → Aircraft definitions: reads and updates (evidence: `src/yourcontrols/src/program/emulator_runtime.rs`)
- Emulator runtime → Simulator connector: sets simulator values (evidence: `src/yourcontrols/src/program/emulator_runtime.rs`)
- Browser interface → Browser emulator: coordinates
- Server entry → Hoster service: starts (evidence: `src/yourcontrols-server/src/main.rs`)
- Server entry → Rendezvous service: runs (evidence: `src/yourcontrols-server/src/main.rs`)
- Rendezvous service → Session registry: uses (evidence: `src/yourcontrols-server/src/rendezvous.rs`)
- Rendezvous service → Server registry: uses (evidence: `src/yourcontrols-server/src/rendezvous.rs`)
- Hoster service → Server registry: uses (evidence: `src/yourcontrols-server/src/hoster.rs`)
- Other pilots → Network client: connects through
