# rubyfpv/rubyfpv architecture

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

- Interactive diagram: https://gitdiagram.com/rubyfpv/rubyfpv
- Repository: https://github.com/rubyfpv/rubyfpv

## Overview

RubyFPV is an end-to-end digital FPV radio system for operating UAVs and other remote vehicles. The principal workflow is vehicle-side capture and telemetry/control handling, transport over one or more radio links (optionally through relays), and presentation/control at the ground station. The repository also includes configuration and hardware support, recording and playback, an OSD, and plugin interfaces. The README documents product capabilities, but most runtime source was not sampled; dashed edges with no evidence path mark inferred implementation connections.

Main entry points: [`code/r_station/radio_links.cpp`](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/radio_links.cpp) (Radio Links), [`code/r_vehicle`](https://github.com/rubyfpv/rubyfpv/tree/main/code/r_vehicle) (Vehicle Runtime), [`code/r_central/osd/osd.cpp`](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/osd/osd.cpp) (On-screen Display), [`code/r_vehicle/telemetry.cpp`](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/telemetry.cpp) (Telemetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vehicle["Vehicle Runtime"]
  node_vehicle_runtime["Vehicle Runtime"]
  node_video_capture["Video Sources<br/>[video_sources.cpp]"]
  node_video_tx["Video Transmit"]
  node_vehicle_telemetry["Telemetry<br/>[telemetry.cpp]"]
  node_vehicle_rc["Remote Control<br/>[ruby_rx_rc.cpp]"]
  node_relay["Relay Processing<br/>[relay_rx.cpp]"]
end

subgraph group_transport["Radio Transport"]
  node_radio_links["Radio Links<br/>[radio_links.cpp]"]
  node_radio_packets["Radio Packets<br/>[radiopackets2.h]"]
  node_adaptive_video["Adaptive Video<br/>[adaptive_video.cpp]"]
end

subgraph group_station["Ground Station"]
  node_controller["Controller Runtime<br/>[ruby_central.cpp]"]
  node_controller_launchers["Process Launchers"]
  node_menus["Control Interface<br/>[menu.cpp]"]
  node_station_video["Video Reception"]
  node_telemetry_display["Telemetry Parsing<br/>[parse_msp.cpp]"]
  node_osd["On-screen Display<br/>[osd.cpp]"]
  node_renderer["Graphics Renderer<br/>[render_engine.cpp]"]
  node_media["Recording and Playback<br/>[media.cpp]"]
end

subgraph group_platform["Shared Platform"]
  node_model_config[("Models and Settings<br/>[models.cpp]")]
  node_hardware["Hardware Support<br/>[hardware.cpp]"]
  node_shared_state[("Shared Runtime State<br/>[shared_mem.h]")]
end

subgraph group_extensions["Extensions"]
  node_plugin_sdk["Plugin SDK<br/>[ruby_core_plugin.h]"]
  node_osd_plugins["OSD Plugins<br/>[osd_plugins.cpp]"]
end

node_operator(("Operator"))
node_flight_controller(("Flight Controller"))

node_operator -.->|"controls"| node_menus
node_menus -.->|"configures"| node_controller
node_controller -->|"launches"| node_controller_launchers
node_controller_launchers -.->|"starts processes"| node_vehicle_runtime
node_video_capture -.->|"supplies video"| node_video_tx
node_vehicle_telemetry -.->|"handles telemetry"| node_vehicle_runtime
node_flight_controller -.->|"exchanges telemetry"| node_vehicle_telemetry
node_vehicle_rc -.->|"sends control"| node_flight_controller
node_video_tx -.->|"transmits video"| node_radio_links
node_vehicle_telemetry -.->|"sends telemetry"| node_radio_links
node_radio_links -.->|"uses packets"| node_radio_packets
node_radio_links -.->|"supports relaying"| node_relay
node_adaptive_video -.->|"adjusts encoding"| node_video_tx
node_radio_links -.->|"delivers video"| node_station_video
node_radio_links -.->|"delivers telemetry"| node_telemetry_display
node_station_video -.->|"feeds display"| node_osd
node_telemetry_display -.->|"supplies telemetry"| node_osd
node_osd -.->|"draws through"| node_renderer
node_station_video -.->|"records video"| node_media
node_menus -.->|"edits settings"| node_model_config
node_vehicle_runtime -.->|"uses settings"| node_model_config
node_controller -.->|"shares state"| node_shared_state
node_vehicle_runtime -.->|"shares state"| node_shared_state
node_hardware -.->|"provides interfaces"| node_radio_links
node_plugin_sdk -.->|"defines extension API"| node_osd_plugins
node_osd_plugins -.->|"extends display"| node_osd

click node_vehicle_runtime "https://github.com/rubyfpv/rubyfpv/tree/main/code/r_vehicle"
click node_video_capture "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/video_sources.cpp"
click node_video_tx "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/processor_tx_video.cpp"
click node_vehicle_telemetry "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/telemetry.cpp"
click node_vehicle_rc "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/ruby_rx_rc.cpp"
click node_relay "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/relay_rx.cpp"
click node_radio_links "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/radio_links.cpp"
click node_radio_packets "https://github.com/rubyfpv/rubyfpv/blob/main/code/radio/radiopackets2.h"
click node_adaptive_video "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/adaptive_video.cpp"
click node_controller "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/ruby_central.cpp"
click node_controller_launchers "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/launchers_controller.cpp"
click node_menus "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/menu/menu.cpp"
click node_station_video "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/processor_rx_video.cpp"
click node_telemetry_display "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/parse_msp.cpp"
click node_osd "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/osd/osd.cpp"
click node_renderer "https://github.com/rubyfpv/rubyfpv/blob/main/code/renderer/render_engine.cpp"
click node_media "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/media.cpp"
click node_model_config "https://github.com/rubyfpv/rubyfpv/blob/main/code/base/models.cpp"
click node_hardware "https://github.com/rubyfpv/rubyfpv/blob/main/code/base/hardware.cpp"
click node_shared_state "https://github.com/rubyfpv/rubyfpv/blob/main/code/base/shared_mem.h"
click node_plugin_sdk "https://github.com/rubyfpv/rubyfpv/blob/main/code/public/ruby_core_plugin.h"
click node_osd_plugins "https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/osd/osd_plugins.cpp"

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_vehicle_runtime,node_video_capture,node_video_tx,node_vehicle_telemetry,node_vehicle_rc,node_relay toneBlue
class node_radio_links,node_radio_packets,node_adaptive_video toneAmber
class node_controller,node_controller_launchers,node_menus,node_station_video,node_telemetry_display,node_osd,node_renderer,node_media toneMint
class node_model_config,node_hardware,node_shared_state toneRose
class node_plugin_sdk,node_osd_plugins,node_operator,node_flight_controller toneIndigo
```

## Components

### Vehicle Runtime

- [Vehicle Runtime](https://github.com/rubyfpv/rubyfpv/tree/main/code/r_vehicle): `code/r_vehicle`
- [Video Sources](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/video_sources.cpp): `code/r_vehicle/video_sources.cpp`
- [Video Transmit](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/processor_tx_video.cpp): `code/r_vehicle/processor_tx_video.cpp`
- [Telemetry](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/telemetry.cpp): `code/r_vehicle/telemetry.cpp`
- [Remote Control](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/ruby_rx_rc.cpp): `code/r_vehicle/ruby_rx_rc.cpp`
- [Relay Processing](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/relay_rx.cpp): `code/r_station/relay_rx.cpp`

### Radio Transport

- [Radio Links](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/radio_links.cpp): `code/r_station/radio_links.cpp`
- [Radio Packets](https://github.com/rubyfpv/rubyfpv/blob/main/code/radio/radiopackets2.h): `code/radio/radiopackets2.h`
- [Adaptive Video](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_vehicle/adaptive_video.cpp): `code/r_vehicle/adaptive_video.cpp`

### Ground Station

- [Controller Runtime](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/ruby_central.cpp): `code/r_central/ruby_central.cpp`
- [Process Launchers](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/launchers_controller.cpp): `code/r_central/launchers_controller.cpp`
- [Control Interface](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/menu/menu.cpp): `code/r_central/menu/menu.cpp`
- [Video Reception](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_station/processor_rx_video.cpp): `code/r_station/processor_rx_video.cpp`
- [Telemetry Parsing](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/parse_msp.cpp): `code/r_central/parse_msp.cpp`
- [On-screen Display](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/osd/osd.cpp): `code/r_central/osd/osd.cpp`
- [Graphics Renderer](https://github.com/rubyfpv/rubyfpv/blob/main/code/renderer/render_engine.cpp): `code/renderer/render_engine.cpp`
- [Recording and Playback](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/media.cpp): `code/r_central/media.cpp`

### Shared Platform

- [Models and Settings](https://github.com/rubyfpv/rubyfpv/blob/main/code/base/models.cpp): `code/base/models.cpp`
- [Hardware Support](https://github.com/rubyfpv/rubyfpv/blob/main/code/base/hardware.cpp): `code/base/hardware.cpp`
- [Shared Runtime State](https://github.com/rubyfpv/rubyfpv/blob/main/code/base/shared_mem.h): `code/base/shared_mem.h`

### Extensions

- [Plugin SDK](https://github.com/rubyfpv/rubyfpv/blob/main/code/public/ruby_core_plugin.h): `code/public/ruby_core_plugin.h`
- [OSD Plugins](https://github.com/rubyfpv/rubyfpv/blob/main/code/r_central/osd/osd_plugins.cpp): `code/r_central/osd/osd_plugins.cpp`

### Other components

- **Operator**
- **Flight Controller**

## Connections

- Operator → Control Interface: controls
- Control Interface → Controller Runtime: configures
- Controller Runtime → Process Launchers: launches (evidence: `code/r_central/launchers_controller.cpp`)
- Process Launchers → Vehicle Runtime: starts processes
- Video Sources → Video Transmit: supplies video
- Telemetry → Vehicle Runtime: handles telemetry
- Flight Controller → Telemetry: exchanges telemetry
- Remote Control → Flight Controller: sends control
- Video Transmit → Radio Links: transmits video
- Telemetry → Radio Links: sends telemetry
- Radio Links → Radio Packets: uses packets
- Radio Links → Relay Processing: supports relaying
- Adaptive Video → Video Transmit: adjusts encoding
- Radio Links → Video Reception: delivers video
- Radio Links → Telemetry Parsing: delivers telemetry
- Video Reception → On-screen Display: feeds display
- Telemetry Parsing → On-screen Display: supplies telemetry
- On-screen Display → Graphics Renderer: draws through
- Video Reception → Recording and Playback: records video
- Control Interface → Models and Settings: edits settings
- Vehicle Runtime → Models and Settings: uses settings
- Controller Runtime → Shared Runtime State: shares state
- Vehicle Runtime → Shared Runtime State: shares state (evidence: `code/r_vehicle/ruby_rx_commands.cpp`)
- Hardware Support → Radio Links: provides interfaces
- Plugin SDK → OSD Plugins: defines extension API
- OSD Plugins → On-screen Display: extends display
