rtl_433

rtl_433 (despite the name) is a generic data receiver, mainly for the 433.92 MHz, 868 MHz (SRD), 315 MHz, 345 MHz, and 915 MHz ISM bands.

The official source code is in the https://github.com/merbanan/rtl_433/ repository.

See also a list of software that works with rtl_433 in the wiki. For more documentation and related projects, particularly those that help with rtl_433 development, see the https://triq.org/ site.

It works with RTL-SDR and/or SoapySDR. Actively tested and supported are Realtek RTL2832 based DVB dongles (using RTL-SDR) and LimeSDR (LimeSDR USB and LimeSDR mini engineering samples kindly provided by MyriadRf), PlutoSDR, HackRF One (using SoapySDR drivers), as well as SoapyRemote.

Building

rtl_433 is written in portable C (C99 standard) and known to compile on Linux (also embedded), FreeBSD, MacOS, and Windows systems. Older compilers and toolchains are supported as a key-goal. Low resource consumption and very few dependencies allow rtl_433 to run on embedded hardware. Most common 32-bit and 64-bit CPU architectures like amd64, arm64, armhf, i386, ppc64el, riscv64, s390x and others are well supported.

See BUILDING.md

Installation

Linux (Debian, Ubuntu): sudo apt install rtl-433. For other distributions see repology or pkgs.org.

FreeBSD: pkg install rtl-433.

MacOS: brew install rtl_433.

Docker images with rtl_433 are available on the github page of hertzg.

How to add support for unsupported sensors

See CONTRIBUTING.md.

Running

rtl_433 -h

```

A "rtl_433.conf" file is searched in "./", XDG_CONFIG_HOME e.g. "$HOME/.config/rtl_433/", SYSCONFDIR e.g. "/usr/local/etc/rtl_433/", then command line args will be parsed in order. = General options = [-V] Output the version string and exit [-v] Increase verbosity (can be used multiple times). -v : verbose notice, -vv : verbose info, -vvv : debug, -vvvv : trace. [-c ] Read config options from a file = Tuner options = [-d | : | | rtl_tcp | help] [-g | help] (default: auto) [-t ] apply a list of keyword=value settings to the SDR device e.g. for SoapySDR -t "antenna=A,bandwidth=4.5M,rfnotch_ctrl=false" for RTL-SDR use "direct_samp[=1]", "offset_tune[=1]", "digital_agc[=1]", "biastee[=1]" [-f ] Receive frequency(s) (default: 433920000 Hz) [-H ] Hop interval for polling of multiple frequencies (default: 600 seconds) [-p ] Correct rtl-sdr tuner frequency offset error (default: 0) [-s ] Set sample rate (default: 250000 Hz) [-D quit | restart | pause | manual] Input device run mode options (default: quit). = Demodulator options = [-R | help] Enable only the specified device decoding protocol (can be used multiple times) Specify a negative number to disable a device decoding protocol (can be used multiple times) [-X | help] Add a general purpose decoder (prepend -R 0 to disable all decoders) [-Y auto | classic | minmax] FSK pulse detector mode. [-Y level=] Manual detection level used to determine pulses (-1.0 to -30.0) (0=auto). [-Y minlevel=] Manual minimum detection level used to determine pulses (-1.0 to -99.0). [-Y minsnr=] Minimum SNR to determine pulses (1.0 to 99.0). [-Y autolevel] Set minlevel automatically based on average estimated noise. [-Y squelch] Skip frames below estimated noise level to reduce cpu load. [-Y ampest | magest] Choose amplitude or magnitude level estimator. [-Y filter=] Manual FM low-pass filter cutoff to separate simultaneous transmissions: us (1-9999, e.g. 20), Hz (10000+), or ratio of sample rate (0.0-1.0). = Analyze/Debug options = [-A] Pulse Analyzer. Enable pulse analysis and decode attempt. Disable all decoders with -R 0 if you want analyzer output only. [-y ] Verify decoding of demodulated test data (e.g. "{25}fb2dd58") with enabled devices = File I/O options = [-S none | all | unknown | known] Signal auto save. Creates one file per signal. Note: Saves raw I/Q samples (uint8 pcm, 2 channel). Preferred mode for generating test files. [-r | help] Read data from input file instead of a receiver [-w | help] Save data stream to output file (a '-' dumps samples to stdout) [-W | help] Save data stream to output file, overwrite existing file = Data output options = [-F log | kv | json | csv | mqtt | influx | syslog | trigger | rtl_tcp | http | null | help] Produce decoded output in given format. Append output to file with : (e.g. -F csv:log.csv), defaults to stdout. Specify host/port for syslog with e.g. -F syslog:127.0.0.1:1514 [-M time[:] | protocol | level | noise[:] | stats | bits | help] Add various meta data to each output. [-K FILE | PATH | | =] Add an expanded token or fixed tag to every output line. [-C native | si | customary] Convert units in decoded output. [-n ] Specify number of samples to take (each sample is an I/Q pair) [-T ] Specify number of seconds to run, also 12:34 or 1h23m45s [-E hop | quit] Hop/Quit after outputting successful event(s) [-h] Output this usage help and exit Use -d, -g, -R, -X, -F, -M, -r, -w, or -W without argument for more help

    = Supported device protocols =
[01]  Silvercrest Remote Control
[02]  Rubicson, TFA 30.3197 or InFactory PT-310 Temperature Sensor
[03]  Prologue, FreeTec NC-7104, NC-7159-675 temperature sensor
[04]  Waveman Switch Transmitter
[06]* ELV EM 1000
[07]* ELV WS 2000
[08]  LaCrosse TX Temperature / Humidity Sensor, TX5U rain gauge
[10]  Acurite 896 Rain Gauge
[11]  Acurite 609TXC Temperature and Humidity Sensor
[12]  Oregon Scientific Weather Sensor
[13]* Mebus 433
[14]* Intertechno 433
[15]  KlikAanKlikUit Wireless Switch
[16]  AlectoV1 Weather Sensor (Alecto WS3500 WS4500 Ventus W155/W044 Oregon)
[17]  Cardin S466-TX2
[18]  Fine Offset Electronics, WH2, WH5, Telldus Temperature/Humidity/Rain Sensor
[19]  Nexus, FreeTec NC-7345, NX-3980, Solight TE82S, TFA 30.3209 temperature/humidity sensor
[20]  Ambient Weather F007TH, TFA 30.3208.02, SwitchDocLabs F016TH temperature sensor
[21]  Calibeur RF-104 Sensor
[22]  X10 RF
[23]  DSC Security Contact
[24]* Brennenstuhl RCS 2044
[25]  Globaltronics GT-WT-02 Sensor
[26]  Danfoss CFR Thermostat
[29]* Chuango Security Technology
[30]  Generic Remote SC226x EV1527
[31]  TFA-Twin-Plus-30.3049, Conrad KW9010, Ea2 BL999
[32]  Fine Offset Electronics WH1080/WH3080 Weather Station
[33]  WT450, WT260H, WT405H
[34]  LaCrosse WS-2310 / WS-3600 Weather Station
[35]  Esperanza EWS
[36]  Efergy e2 classic
[37]* Inovalley kw9015b, TFA Dostmann 30.3161 (Rain and temperature sensor)
[38]  Generic temperature sensor 1
[39]  WG-PB12V1 Temperature Sensor
[40]  Acurite 592TXR temp/humidity, 592TX temp, 5n1, 3n1, Atlas weather station, 515 fridge/freezer, 6045 lightning, 899 rain, 1190/1192 leak
[41]  Acurite 986 Refrigerator / Freezer Thermometer
[42]  HIDEKI TS04 Temperature, Humidity, Wind and Rain Sensor
[43]  Watchman Sonic / Apollo Ultrasonic / Beckett Rocket oil tank monitor
[44]  CurrentCost Current Sensor
[45]  emonTx OpenEnergyMonitor
[46]  HT680 Remote control
[47]  Conrad S3318P, FreeTec NC-5849-913 temperature humidity sensor, ORIA WA50 ST389 temperature sensor
[48]* Akhan 100F14 remote keyless entry
[49]  Quhwa
[50]  OSv1 Temperature Sensor
[51]  Proove / Nexa / KlikAanKlikUit Wireless Switch
[52]  Bresser Thermo-/Hygro-Sensor 3CH
[53]  Springfield Temperature and Soil Moisture
[54]  Oregon Scientific SL109H Remote Thermal Hygro Sensor
[55]  Acurite 606TX / Technoline TX960 Temperature Sensor
[56]  TFA pool temperature sensor
[57]  Kedsum Temperature & Humidity Sensor, Pearl NC-7415
[58]  Blyss DC5-UK-WH
[59]  Steelmate TPMS
[60]  Schrader TPMS
[61]* LightwaveRF
[62]* Elro DB286A Doorbell
[63]  Efergy Optical
[64]* Honda Car Key
[67]  Radiohead ASK
[68]  Kerui PIR / Contact Sensor
[69]  Fine Offset WH1050 Weather Station
[70]  Honeywell Door/Window Sensor, 2Gig DW10/DW11, RE208 repeater
[71]  Maverick ET-732/733 BBQ Sensor
[72]* RF-tech
[73]  LaCrosse TX141-Bv2, TX141TH-Bv2, TX141-Bv3, TX141W, TX145wsdth, (TFA, ORIA) sensor
[74]  Acurite 00275rm,00276rm Temp/Humidity with optional probe
[75]  LaCrosse TX35DTH-IT, TFA Dostmann 30.3155 Temperature/Humidity sensor
[76]  LaCrosse TX29IT, TFA Dostmann 30.3159.IT Temperature sensor
[77]  Vaillant calorMatic VRT340f Central Heating Control
[78]  Fine Offset Electronics, WH25, WH32, WH32B, WN32B, WH24, WH65, WS69, HP1000, Misol WS2320 Temperature/Humidity/Pressure Sensor
[79]  Fine Offset Electronics, WH0530 Temperature/Rain Sensor
[80]  IBIS beacon
[81]  Oil Ultrasonic STANDARD FSK
[82]  Citroen TPMS
[83]  Oil Ultrasonic STANDARD ASK
[84]  Thermopro TP11 Thermometer
[85]  Solight TE44/TE66, EMOS E0107T, NX-6876-917
[86]* Wireless Smoke and Heat Detector GS 558
[87]  Generic wireless motion sensor
[88]  Toyota TPMS
[89]  Ford TPMS
[90]  Renault TPMS
[91]  inFactory, nor-tec, FreeTec NC-3982-913 temperature humidity sensor
[92]  FT-004-B Temperature Sensor
[93]* Ford Car Key
[94]  Philips outdoor temperature sensor (type AJ3650)
[95]  Schrader TPMS EG53MA4, Saab, Opel, Vauxhall, Chevrolet
[96]  Nexa
[97]  ThermoPro TP08/TP12/TP20 thermometer
[98]  GE Color Effects
[99]  X10 Security
[100]  Interlogix GE UTC Security Devices
[101]* Dish remote 6.3
[102]  SimpliSafe Home Security System (May require disabling automatic gain for KeyPad decodes)
[103]  Sensible Living Mini-Plant Moisture Sensor
[104]  Wireless M-Bus, Mode C&T, 100kbps (-f 868.95M -s 1200k)
[105]  Wireless M-Bus, Mode S, 32.768kbps (-f 868.3M -s 1000k)
[106]* Wireless M-Bus, Mode R, 4.8kbps (-f 868.33M)
[107]* Wireless M-Bus,