How moonlight-os/helios works
Helios is a Moonlight-compatible streaming host. A client pairs and configures access, then starts a session that captures and encodes host video, handles input and peripherals, and delivers the stream over negotiated transport. The README also documents virtual displays, browser-based administration, file/clipboard permissions, camera and microphone uplinks, and recovery/update capabilities. The source index identifies principal implementation areas, but much of their runtime wiring was not excerpted; uncertain links are marked dashed rather than inferred as calls.
Main entry points: stream.cpp Session orchestration · entry_handler.cpp HTTP entry handling · nvhttp.cpp Pairing and protocol · display_vram.cpp Display capture
Components 24
Host control
- Host startup
src/main.cpp - Runtime configuration
src/config.h - Browser configuration
src/confighttp.cpp - HTTP entry handling
src/entry_handler.cpp - File permissions
src/file_handler.cpp - Network services
src/network.cpp - Pairing and protocol
src/nvhttp.cpp
Streaming session
- Session orchestration
src/stream.cpp - Video pipeline
src/video.cpp - NVENC encoding
src/nvenc/nvenc_base.cpp - Input handling
src/input.cpp - Audio handling
src/audio.cpp - QUIC transport
src/quic_transport.cpp - USB forwarding
src/usb_backend.cpp - Camera uplink
src/platform/windows/camera.cpp
Platform services
- Display capture
src/platform/windows/display_vram.cpp - Linux display topology
src/platform/linux/client_topology.cpp - Display management
src/display_device.h
Host integrations
- Cryptographic services
src/crypto.cpp - Port mapping
src/upnp.cpp - Logging and telemetry
src/logging.cpp - Signed updates
src/updater.cpp
Other components
- Moonlight client
- Host operating system
Connections 22
- Moonlight client → Pairing and protocol: pairs and negotiates
- Moonlight client → Browser configuration: uses configuration
- Host startup → HTTP entry handling: starts host
src/main.cpp - HTTP entry handling → Network services: uses network services
src/entry_handler.cpp - HTTP entry handling → Runtime configuration: uses settings
src/entry_handler.cpp - Pairing and protocol → Session orchestration: negotiates sessions
- Session orchestration → Display capture: captures frames
- Display capture → Video pipeline: supplies frames
src/platform/windows/display_vram.cpp - Video pipeline → NVENC encoding: encodes video
- Session orchestration → Input handling: handles client input
- Session orchestration → Audio handling: streams audio
- Session orchestration → QUIC transport: uses negotiated transport
- Session orchestration → USB forwarding: forwards session USB
- Session orchestration → Camera uplink: accepts camera uplink
- Session orchestration → File permissions: enforces file access
- Session orchestration → Display management: manages client displays
- Linux display topology → Host operating system: controls Sway outputs
src/platform/linux/client_topology.cpp - Display capture → Host operating system: captures host display
- Pairing and protocol → Cryptographic services: authenticates clients
- Network services → Port mapping: maps network ports
- Host startup → Logging and telemetry: initializes host logging
src/main.cpp - Signed updates → Host operating system: applies signed releases