rtl_433 currently supports these input types:
Building rtl_433 with RTL-SDR or SoapySDR support is optional but using RTL-SDR is highly recommended. The libraries and header files for RTL-SDR and/or SoapySDR should be installed beforehand.
Some distributions offer nightly builds.
openSUSE users of at least Leap 42.3 or Tumbleweed can add the repository with daily builds:
$ sudo zypper addrepo -f obs://home:mnhauke:rtl_433:nightly/rtl_433 rtl_433-nightly $ sudo zypper install rtl_433
The usual update mechanism will now keep the rtl_433 version current.
Depending on your system, you may need to install the following libraries.
sudo apt-get install libtool libusb-1.0-0-dev librtlsdr-dev rtl-sdr build-essential autoconf cmake pkg-config
Centos/Fedora/RHEL with EPEL repo using cmake:
dnf doesn't exist, use
sudo dnf install libtool libusbx-devel rtl-sdr-devel rtl-sdr cmake
Mac OS X with MacPorts:
sudo port install rtl-sdr cmake
Mac OS X with Homebrew:
brew install rtl-sdr cmake pkg-config
Installation using CMake:
cd rtl_433/ mkdir build cd build cmake .. make make install
Use CMake with
AUTO) to require SoapySDR, use
ON) to disable RTL-SDR if needed.
cmake -DENABLE_SOAPYSDR=ON ..
Installation using Autotools:
cd rtl_433/ autoreconf --install ./configure make make install
The final 'make install' step should be run as a user with appropriate permissions - if in doubt, 'sudo' it.
You'll probably want librtlsdr and libusb.
libusb has prebuilt binaries for windows, librtlsdr needs to be built (at least for the latest version, some binaries of older versions seem to be floating around)
taken and adapted from here: https://www.onetransistor.eu/2017/03/compile-librtlsdr-windows-mingw.html
mingw64/dll/libusb-1.0.dll.afile to `/lib
# Find build dependencies(around line 65) and comment/remove the line with
add the following lines instead:
SET(CMAKE_THREAD_LIBS_INIT "-lpthread") SET(CMAKE_HAVE_THREADS_LIBRARY 1) SET(THREADS_FOUND TRUE)
go into the cmake/modules folder and open FindLibUSB.cmake with a text editor
find the lines with the following text in them
/usr/include/libusb-1.0 /usr/include /usr/local/include
add some extra lines to point to the MinGW include folder where you extracted libusb-1.0, making it look like this
you'll need to find out the exact paths for your system
/usr/include/libusb-1.0 /usr/include /usr/local/include "C:/Program Files/mingw-w64/x86_64-8.1.0-posix-seh-rt_v6-rev0/mingw64/include" "C:/Program Files/mingw-w64/x86_64-8.1.0-posix-seh-rt_v6-rev0/mingw64/include/libusb-1.0"
open a MinGW terminal in the librtlsdr folder
create build folder and go into it:
mkdir build && cd build
generate makefiles for MinGW:
cmake -G "MinGW Makefiles" ..
build the librtlsdr library:
mkdir build && cd build
cmake -G "MinGW Makefiles" ..in the build directory
LIBRTLSDR_INCLUDE_DIRSto the include folder of the librtlsdr source
librtlsdr.dll.afile in the /build/src folder
add_subdirectory(tests)in the CMakeLists.txt file in the source folder of rtl_433
cd rtl_433 mkdir build cd build cmake -G "Visual Studio 15 2017 Win64" .. MSBuild.exe rtl433.sln
rtl_433.sln from the
vs15 folder -or-
cd rtl_433 cd vs15 MSBuild.exe rtl_433.sln
If your system is missing or you find these steps are outdated please PR an update or open an issue.