# merbanan/rtl_433

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/merbanan-rtl-433).**

7,529 stars · 1,533 forks · C · GPL-2.0

## Links

- GitHub: https://github.com/merbanan/rtl_433
- awesome-repositories: https://awesome-repositories.com/repository/merbanan-rtl-433.md

## Topics

`433mhz` `rf` `rtl-sdr` `sdr` `sensors` `signal-processing`

## Description

This project is a software-defined radio signal decoder and protocol analyzer designed to translate raw radio transmissions from ISM bands into human-readable data. It functions as a tool for capturing radio samples, analyzing pulse timings, and decoding signals from wireless devices.

The system acts as a data bridge, converting decoded radio signals into JSON format for publication to MQTT brokers or exposure via Prometheus-compatible endpoints. It also serves as a signal capture tool capable of recording raw radio samples and demodulated pulses to files for offline analysis and simulated playback.

The software covers a broad range of capabilities, including hardware integration through standardized APIs for receiver tuning, signal processing via noise filtering and multi-frequency polling, and data integration for streaming to time-series databases. It further provides tools for radio protocol analysis by calculating pulse and gap distributions to identify unknown transmission patterns.

Hardware and decoder settings are managed through persistent file-based configuration.

## Tags

### Hardware & IoT

- [Wireless Protocol Decoders](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/wireless-signal-recorders/wireless-protocol-decoders.md) — Translates raw radio transmissions from ISM bands into human-readable data using software defined radio hardware.
- [Hardware Abstraction Layers](https://awesome-repositories.com/f/hardware-iot/hardware-abstraction-layers.md) — Interfaces with varied radio hardware through a standardized layer to manage frequency tuning and gain settings.
- [Hardware Interface Standardizations](https://awesome-repositories.com/f/hardware-iot/hardware-interface-standardizations.md) — Uses a standardized API to abstract hardware control across different software-defined radio brands. ([source](https://github.com/merbanan/rtl_433/blob/master/CHANGELOG.md))
- [Pulse Demodulators](https://awesome-repositories.com/f/hardware-iot/pulse-demodulators.md) — Converts raw radio samples into a sequence of timed pulses and gaps for protocol analysis.
- [Frequency Tuning](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/frequency-tuning.md) — Provides precise adjustment of receiver frequencies and gain to optimize the capture of radio signals. ([source](https://github.com/merbanan/rtl_433/blob/master/README.md))
- [Radio Signal Analysis](https://awesome-repositories.com/f/hardware-iot/radio-frequency-transceivers/radio-signal-analysis.md) — Analyzes pulse timings and signal patterns to identify and decode unknown radio transmission protocols.
- [Pulse Distribution Analysis](https://awesome-repositories.com/f/hardware-iot/radio-frequency-transceivers/radio-signal-analysis/pulse-distribution-analysis.md) — rtlsdr-decoder summarizes the duration of pulses, gaps, and periods to identify unknown transmission patterns. ([source](https://github.com/merbanan/rtl_433#readme))
- [Signal Noise Filtering](https://awesome-repositories.com/f/hardware-iot/signal-noise-filtering.md) — Uses squelch and autolevel settings to remove background noise and isolate radio transmissions. ([source](https://github.com/merbanan/rtl_433/blob/master/CHANGELOG.md))
- [Software Defined Radios](https://awesome-repositories.com/f/hardware-iot/software-defined-radios.md) — Connects and tunes software defined radio receivers to capture radio signals across various frequencies and bands.
- [Pulse Timing Analysis](https://awesome-repositories.com/f/hardware-iot/pulse-width-modulation-controllers/pulse-timing-configurations/pulse-timing-analysis.md) — Summarizes the duration of pulses, gaps, and periods to identify unknown transmission patterns. ([source](https://github.com/merbanan/rtl_433/blob/master/README.md))
- [Frequency Scanners](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/frequency-scanners.md) — Implements a system to cycle through a list of frequencies to monitor multiple radio bands sequentially.
- [Frequency Scanning and Monitoring](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/frequency-scanning-and-monitoring.md) — rtlsdr-decoder hops between a list of different radio frequencies at set intervals to monitor multiple bands. ([source](https://github.com/merbanan/rtl_433#readme))
- [Wireless Signal Recorders](https://awesome-repositories.com/f/hardware-iot/radio-frequency-signal-processing/wireless-signal-recorders.md) — Captures raw radio samples to files for offline analysis, testing, and simulated playback.
- [Signal Capture and Replay](https://awesome-repositories.com/f/hardware-iot/radio-frequency-transceivers/signal-capture-and-replay.md) — Records raw radio samples and demodulated pulses to files for offline analysis and playback.
- [Signal Replayers](https://awesome-repositories.com/f/hardware-iot/rf-signal-sampling/signal-replayers.md) — Reads recorded data files to simulate radio receptions instead of listening to live airwaves. ([source](https://github.com/merbanan/rtl_433#readme))
- [Wireless Sensor Monitors](https://awesome-repositories.com/f/hardware-iot/wireless-sensor-monitors.md) — Collects data from wireless sensors and exports it to MQTT brokers or databases for home automation.

### System Administration & Monitoring

- [Radio Signal Decoders](https://awesome-repositories.com/f/system-administration-monitoring/radio-signal-monitoring/radio-signal-decoders.md) — Translates raw radio transmissions from ISM bands into human-readable data using software-defined radio hardware.
- [IQ Sample Replays](https://awesome-repositories.com/f/system-administration-monitoring/execution-history-auditors/reverse-execution-simulation/record-and-replay-debugging/data-stream-recording-and-replay/iq-sample-replays.md) — Feeds recorded raw I/Q signal data back through the decoding pipeline to simulate live radio receptions.
- [Prometheus-Formatted HTTP Endpoints](https://awesome-repositories.com/f/system-administration-monitoring/metrics-exporters/prometheus-formatted-http-endpoints.md) — Exposes decoded radio metrics via a Prometheus-formatted HTTP endpoint for remote observation.

### Networking & Communication

- [Protocol Analyzers](https://awesome-repositories.com/f/networking-communication/network-infrastructure-routing/wireless-network-utilities/dual-band-network-scanning/ism-band-scanning/protocol-analyzers.md) — Analyzes pulse timings and signal distributions to identify and decode unknown radio transmission patterns.
- [Radio](https://awesome-repositories.com/f/networking-communication/transport-bridges/protocol-bridges/radio.md) — Translates decoded radio signals into JSON format for publication to MQTT brokers.

### Software Engineering & Architecture

- [Signal Pattern Matchers](https://awesome-repositories.com/f/software-engineering-architecture/pattern-matching-libraries/signal-pattern-matchers.md) — Matches demodulated pulse sequences against a library of known device signatures to extract human-readable data.
- [Radio Data Exporters](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/plugin-module-systems/modular-plugin-architectures/plugin-based-architectures/event-export-plugins/radio-data-exporters.md) — Routes decoded signal information to various external sinks like MQTT, JSON-RPC, or time-series databases.

### Data & Databases

- [MQTT Connectors](https://awesome-repositories.com/f/data-databases/data-integration-synchronization/mqtt-integrations/mqtt-connectors.md) — Converts decoded signal data to JSON and sends it to an MQTT broker for system integration. ([source](https://github.com/merbanan/rtl_433#readme))
- [Time-Series Data Forwarding](https://awesome-repositories.com/f/data-databases/time-series-databases/time-series-data-forwarding.md) — Relays decoded radio signals to time-series databases or monitoring systems for long-term storage and visualization. ([source](https://github.com/merbanan/rtl_433/tree/master/examples))

### Graphics & Multimedia

- [IQ Sample Captures](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-capture-and-playback/raw-audio-captures/iq-sample-captures.md) — Records raw in-phase and quadrature radio samples from SDR hardware to storage for analysis. ([source](https://github.com/merbanan/rtl_433/blob/master/README.md))
