How tb0ne/nightfall works
Nightfall is a VR streaming suite: the headset client discovers or pairs with a PC host, configures a stream, receives media, and presents it as adjustable VR screens. Optional Meteor adds managed hosting, PCVR, host-side depth inference, and microphone passthrough. The graph preserves browser, USB, passthrough, and depth capabilities alongside the main stream flow. Relationships among unsampled subsystems are documented-level links, not claims of inspected call paths; source excerpts and the index confirm selected implementations and imports.
Main entry points: nightfall_stream.cpp VR client · main.rs Meteor companion · stream_connection.cpp Video decoding · depth.rs Host depth inference
Components 26
Headset client
- VR client
addons/nightfall-stream/src/nightfall_stream.cpp - Discovery and pairing
addons/nightfall-stream/src/config/computer_manager.cpp - Host and stream settings
addons/nightfall-stream/src/config/config_manager.cpp - Browser features
android/src/main/java/com/godot/game/BrowserNavigation.java - Optional ad blocking
extensions/browser-adblock/src/lib.rs
Streaming and media
- Stream control
addons/nightfall-stream/src/config/computer_manager.cpp - Compatible PC host
- Video decoding
addons/nightfall-stream/src/video/stream_connection.cpp - PyroWave GPU decode
addons/nightfall-stream/src/video/pyrowave_gpu_pipeline.cpp - Audio playback
addons/nightfall-stream/src/audio/audio_renderer.cpp - Controller and keyboard input
addons/nightfall-stream/src/input/input_bridge.cpp - USB Link
addons/nightfall-stream/src/network/usb_link_bridge.cpp
Meteor host
- Meteor companion
meteor/src/main.rs - Meteor configuration
meteor/src/config.rs - Managed host
meteor/src/host/mod.rs - Host setup and pairing
meteor/src/host/pairing.rs - Microphone passthrough
meteor/src/mic.rs
Depth processing
- Video depth feed
meteor/src/depth.rs - Host depth inference
meteor/src/depth.rs - Inference backends
meteor/src/vda.rs - Depth postprocessing
meteor/src/gpu_post.rs - On-headset depth
addons/nightfall-stream/src/video/midas_depth_engine.cpp
PCVR and XR
- PCVR client extension
extensions/nightfall-xr/src/pcvr_alvr_client.cpp - XR relay
meteor/src/xr_relay.rs - XR session adapter
meteor/src/xr_session_windows.rs
Other components
- Headset user
Connections 27
- Headset user → VR client: operates
README.md - VR client → Discovery and pairing: selects host
- Discovery and pairing → Host and stream settings: updates hosts
addons/nightfall-stream/src/config/computer_manager.cpp - VR client → Browser features: opens pages
- Browser features → Optional ad blocking: optionally filters
- VR client → Stream control: configures stream
- Stream control → Compatible PC host: requests stream
README.md - Compatible PC host → Video decoding: sends video
README.md - Video decoding → PyroWave GPU decode: decodes PyroWave
- Video decoding → VR client: renders screens
- Compatible PC host → Audio playback: sends audio
- VR client → Controller and keyboard input: forwards controls
- VR client → USB Link: uses USB Link
README.md - VR client → On-headset depth: runs local depth
README.md - VR client → Meteor companion: discovers companion
meteor/src/main.rs - Meteor companion → Meteor configuration: loads settings
meteor/src/main.rs - Meteor companion → Managed host: offers managed host
README.md - Meteor companion → Host setup and pairing: supports PIN approval
README.md - Meteor companion → Microphone passthrough: provides microphone
README.md - Meteor companion → Video depth feed: starts depth service
meteor/src/main.rs - Video depth feed → Host depth inference: feeds frames
meteor/src/depth.rs - Host depth inference → Inference backends: runs inference
meteor/src/depth.rs - Host depth inference → Depth postprocessing: postprocesses maps
meteor/src/depth.rs - Depth postprocessing → VR client: sends depth maps
README.md - VR client → PCVR client extension: launches PCVR
README.md - Meteor companion → XR relay: provides XR relay
- XR session adapter → XR relay: manages session
meteor/src/xr_session_windows.rs