# merbanan/rtl_433 architecture

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

- Interactive diagram: https://gitdiagram.com/merbanan/rtl_433
- Repository: https://github.com/merbanan/rtl_433

## Overview

rtl_433 is a generic receiver for wireless sensor and device protocols. Its principal workflow is to acquire SDR or file samples, detect and slice radio pulses, decode protocol frames into structured events, then emit those events through selectable output formats. The tree and README also identify configuration, signal analysis, an HTTP interface, and a large decoder catalog as product capabilities. Several runtime links are dashed because the supplied source excerpts do not show their call sites; the README documents supported inputs and outputs but not all internal wiring.

Main entry points: [`src/rtl_433.c`](https://github.com/merbanan/rtl_433/blob/master/src/rtl_433.c) (Receiver runtime), [`src/sdr.c`](https://github.com/merbanan/rtl_433/blob/master/src/sdr.c) (SDR input), [`src/fileformat.c`](https://github.com/merbanan/rtl_433/blob/master/src/fileformat.c) (File input), [`src/baseband.c`](https://github.com/merbanan/rtl_433/blob/master/src/baseband.c) (Baseband processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Signal capture"]
  node_rtl433["Receiver runtime<br/>[rtl_433.c]"]
  node_sdr["SDR input<br/>[sdr.c]"]
  node_file_input["File input<br/>[fileformat.c]"]
  node_sample_save["Signal capture<br/>[samp_grab.c]"]
end

subgraph group_decode["Demodulation and decoding"]
  node_baseband["Baseband processing<br/>[baseband.c]"]
  node_pulse_detect["Pulse detection<br/>[pulse_detect.c]"]
  node_pulse_slicer["Pulse slicing<br/>[pulse_slicer.c]"]
  node_protocols["Protocol decoders"]
  node_registry["Decoder registry<br/>[r_api.c]"]
end

subgraph group_events["Event processing"]
  node_data["Structured events<br/>[data.c]"]
  node_analysis["Pulse analysis<br/>[pulse_analyzer.c]"]
end

subgraph group_outputs["Output interfaces"]
  node_output_file["File output<br/>[output_file.c]"]
  node_output_log["Log output<br/>[output_log.c]"]
  node_output_mqtt["MQTT output<br/>[output_mqtt.c]"]
  node_output_influx["Influx output<br/>[output_influx.c]"]
  node_output_udp["UDP output<br/>[output_udp.c]"]
  node_output_trigger["Trigger output<br/>[output_trigger.c]"]
end

subgraph group_services["Runtime services"]
  node_http_server["HTTP interface<br/>[http_server.c]"]
  node_mongoose["HTTP networking<br/>[mongoose.c]"]
  node_config["Configuration parsing<br/>[confparse.c]"]
end

node_operator(("Operator"))
node_radio["SDR receiver"]
node_sample_files["Sample files"]
node_remote_sinks(("Output services"))

node_operator -->|"configures"| node_rtl433
node_radio -->|"provides samples"| node_sdr
node_sample_files -->|"provides samples"| node_file_input
node_rtl433 -.->|"starts input"| node_sdr
node_rtl433 -.->|"selects input"| node_file_input
node_sdr -.->|"delivers samples"| node_rtl433
node_file_input -.->|"delivers samples"| node_rtl433
node_rtl433 -.->|"saves signals"| node_sample_save
node_rtl433 -.->|"processes samples"| node_baseband
node_baseband -.->|"detects pulses"| node_pulse_detect
node_pulse_detect -.->|"passes pulses"| node_pulse_slicer
node_pulse_slicer -.->|"dispatches frames"| node_registry
node_registry -.->|"selects decoders"| node_protocols
node_protocols -.->|"creates events"| node_data
node_rtl433 -.->|"analyzes signals"| node_analysis
node_rtl433 -.->|"reads options"| node_config
node_rtl433 -.->|"routes events"| node_output_file
node_rtl433 -.->|"routes events"| node_output_log
node_rtl433 -.->|"routes events"| node_output_mqtt
node_rtl433 -.->|"routes events"| node_output_influx
node_rtl433 -.->|"routes events"| node_output_udp
node_rtl433 -.->|"routes events"| node_output_trigger
node_output_mqtt -->|"publishes events"| node_remote_sinks
node_output_influx -->|"writes events"| node_remote_sinks
node_rtl433 -.->|"serves interface"| node_http_server
node_http_server -.->|"uses networking"| node_mongoose

click node_rtl433 "https://github.com/merbanan/rtl_433/blob/master/src/rtl_433.c"
click node_sdr "https://github.com/merbanan/rtl_433/blob/master/src/sdr.c"
click node_file_input "https://github.com/merbanan/rtl_433/blob/master/src/fileformat.c"
click node_sample_save "https://github.com/merbanan/rtl_433/blob/master/src/samp_grab.c"
click node_baseband "https://github.com/merbanan/rtl_433/blob/master/src/baseband.c"
click node_pulse_detect "https://github.com/merbanan/rtl_433/blob/master/src/pulse_detect.c"
click node_pulse_slicer "https://github.com/merbanan/rtl_433/blob/master/src/pulse_slicer.c"
click node_protocols "https://github.com/merbanan/rtl_433/tree/master/src/devices"
click node_registry "https://github.com/merbanan/rtl_433/blob/master/src/r_api.c"
click node_data "https://github.com/merbanan/rtl_433/blob/master/src/data.c"
click node_analysis "https://github.com/merbanan/rtl_433/blob/master/src/pulse_analyzer.c"
click node_output_file "https://github.com/merbanan/rtl_433/blob/master/src/output_file.c"
click node_output_log "https://github.com/merbanan/rtl_433/blob/master/src/output_log.c"
click node_output_mqtt "https://github.com/merbanan/rtl_433/blob/master/src/output_mqtt.c"
click node_output_influx "https://github.com/merbanan/rtl_433/blob/master/src/output_influx.c"
click node_output_udp "https://github.com/merbanan/rtl_433/blob/master/src/output_udp.c"
click node_output_trigger "https://github.com/merbanan/rtl_433/blob/master/src/output_trigger.c"
click node_http_server "https://github.com/merbanan/rtl_433/blob/master/src/http_server.c"
click node_mongoose "https://github.com/merbanan/rtl_433/blob/master/src/mongoose.c"
click node_config "https://github.com/merbanan/rtl_433/blob/master/src/confparse.c"

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_rtl433,node_sdr,node_file_input,node_sample_save toneBlue
class node_baseband,node_pulse_detect,node_pulse_slicer,node_protocols,node_registry toneAmber
class node_data,node_analysis toneMint
class node_output_file,node_output_log,node_output_mqtt,node_output_influx,node_output_udp,node_output_trigger toneRose
class node_http_server,node_mongoose,node_config,node_operator,node_radio,node_sample_files,node_remote_sinks toneIndigo
```

## Components

### Signal capture

- [Receiver runtime](https://github.com/merbanan/rtl_433/blob/master/src/rtl_433.c): `src/rtl_433.c`
- [SDR input](https://github.com/merbanan/rtl_433/blob/master/src/sdr.c): `src/sdr.c`
- [File input](https://github.com/merbanan/rtl_433/blob/master/src/fileformat.c): `src/fileformat.c`
- [Signal capture](https://github.com/merbanan/rtl_433/blob/master/src/samp_grab.c): `src/samp_grab.c`

### Demodulation and decoding

- [Baseband processing](https://github.com/merbanan/rtl_433/blob/master/src/baseband.c): `src/baseband.c`
- [Pulse detection](https://github.com/merbanan/rtl_433/blob/master/src/pulse_detect.c): `src/pulse_detect.c`
- [Pulse slicing](https://github.com/merbanan/rtl_433/blob/master/src/pulse_slicer.c): `src/pulse_slicer.c`
- [Protocol decoders](https://github.com/merbanan/rtl_433/tree/master/src/devices): `src/devices`
- [Decoder registry](https://github.com/merbanan/rtl_433/blob/master/src/r_api.c): `src/r_api.c`

### Event processing

- [Structured events](https://github.com/merbanan/rtl_433/blob/master/src/data.c): `src/data.c`
- [Pulse analysis](https://github.com/merbanan/rtl_433/blob/master/src/pulse_analyzer.c): `src/pulse_analyzer.c`

### Output interfaces

- [File output](https://github.com/merbanan/rtl_433/blob/master/src/output_file.c): `src/output_file.c`
- [Log output](https://github.com/merbanan/rtl_433/blob/master/src/output_log.c): `src/output_log.c`
- [MQTT output](https://github.com/merbanan/rtl_433/blob/master/src/output_mqtt.c): `src/output_mqtt.c`
- [Influx output](https://github.com/merbanan/rtl_433/blob/master/src/output_influx.c): `src/output_influx.c`
- [UDP output](https://github.com/merbanan/rtl_433/blob/master/src/output_udp.c): `src/output_udp.c`
- [Trigger output](https://github.com/merbanan/rtl_433/blob/master/src/output_trigger.c): `src/output_trigger.c`

### Runtime services

- [HTTP interface](https://github.com/merbanan/rtl_433/blob/master/src/http_server.c): `src/http_server.c`
- [HTTP networking](https://github.com/merbanan/rtl_433/blob/master/src/mongoose.c): `src/mongoose.c`
- [Configuration parsing](https://github.com/merbanan/rtl_433/blob/master/src/confparse.c): `src/confparse.c`

### Other components

- **Operator**
- **SDR receiver**
- **Sample files**
- **Output services**

## Connections

- Operator → Receiver runtime: configures
- SDR receiver → SDR input: provides samples
- Sample files → File input: provides samples
- Receiver runtime → SDR input: starts input
- Receiver runtime → File input: selects input
- SDR input → Receiver runtime: delivers samples
- File input → Receiver runtime: delivers samples
- Receiver runtime → Signal capture: saves signals
- Receiver runtime → Baseband processing: processes samples
- Baseband processing → Pulse detection: detects pulses
- Pulse detection → Pulse slicing: passes pulses
- Pulse slicing → Decoder registry: dispatches frames
- Decoder registry → Protocol decoders: selects decoders
- Protocol decoders → Structured events: creates events
- Receiver runtime → Pulse analysis: analyzes signals
- Receiver runtime → Configuration parsing: reads options
- Receiver runtime → File output: routes events
- Receiver runtime → Log output: routes events
- Receiver runtime → MQTT output: routes events
- Receiver runtime → Influx output: routes events
- Receiver runtime → UDP output: routes events
- Receiver runtime → Trigger output: routes events
- MQTT output → Output services: publishes events
- Influx output → Output services: writes events
- Receiver runtime → HTTP interface: serves interface
- HTTP interface → HTTP networking: uses networking
