Skip to the content.

Architecture & QUIC Transport

1. End-to-End Pipeline

  omegadesk-agent                                       omegadesk-client
 ┌──────────────────────────────┐    QUIC (TLS 1.3)   ┌───────────────────────────┐
 │ capture -> codec -> transport├─── video stream ───>│ transport -> decode -> UI │
 │ (DXGI)     (MF / OpenH264)   │                     │              (OpenH264)   │
 │ input <──────── control stream: ping, keys, mouse, keyframe requests ──────────┤
 │ (SendInput)                  │                     │ keyboard & mouse (winit)  │
 └──────────────────────────────┘                     └───────────────────────────┘

2. The 17 Modular Workspace Crates

Crate Responsibility
omegadesk-protocol Protobuf session messages, framing, and codec capability negotiation
omegadesk-identity Ed25519 signing keys, X25519 Diffie-Hellman keys, device IDs, and OS keychain storage
omegadesk-capture Screen capture (DXGI Desktop Duplication -> WGC -> GDI fallback chain) + hardware cursor compositing
omegadesk-codec Hardware H.264 encoding (Media Foundation NVENC/QuickSync/AMF) and OpenH264 software encode/decode
omegadesk-input Physical USB HID scancode keyboard injection (layout-independent, including ABNT2) and multi-monitor mouse mapping
omegadesk-transport Multiplexed QUIC (TLS 1.3) streams with certificate fingerprint pinning or mesh identity-bound TLS
omegadesk-noise Noise IK cryptographic handshake bound to coordinator/device identities
omegadesk-mesh Sans-I/O NAT traversal state machine (STUN, disco probes, relay tickets, tunnel encryption)
omegadesk-control Coordinator client for node enrollment, streaming netmap updates, and relay ticket issuance
omegadesk-magicsock Virtual AsyncUdpSocket presenting direct UDP or DERP-relayed paths seamlessly to Quinn QUIC
omegadesk-relay Stateless DERP-style encrypted packet relay with single-use tickets and integrated STUN responder
omegadesk-server Central coordinator (*.omega DNS, HuJSON policy compiler, WebCodecs gateway, and RMM server)
omegadesk-rmm-agent System inventory collector, heartbeat reporter, and sandboxed script runner
omegadesk-service Windows LocalSystem service and per-session winlogon.exe worker for UAC and lock-screen capture
omegadesk-agent Host daemon sharing displays, clipboard, and files
omegadesk-quicksupport Zero-install 9-digit ID ad-hoc support binary with interactive console consent
omegadesk-client Native low-latency desktop viewer with live title-bar telemetry