Turn Old WiFi Gear Into a 320Msps SDR Receiver with GQRX
🤖 Researched and drafted automatically from the official docs, and reviewed before publishing. Commands are taken from the source projects — but always sanity-check before running anything on your own hardware.
Old WiFi routers and access points often end up in e-waste bins, but many contain usable RF hardware. You can extract or repurpose compatible components—particularly RTL-SDR dongles or similar USB SDR receivers—to build a functional software-defined radio station. GQRX is a Linux and Mac application that turns these cheap receivers into AM/FM/SSB radios, spectrum analyzers, and signal monitors. This guide walks you through building and running GQRX on a homelab machine to receive and decode radio signals at up to 320 Msps.
What You’re Building
GQRX is an open-source SDR receiver built on GNU Radio and Qt. It supports multiple hardware backends (RTL-SDR, HackRF, Airspy, etc.) and can operate as a traditional radio, an FFT spectrum analyzer, or a signal-processing pipeline. The goal here is to get it compiled, running, and tuned to real signals on your LAN.
Prerequisites
- A Linux or Mac machine (Windows users can use radioconda)
- A compatible USB SDR receiver: RTL-SDR dongle (~$30 new, free if salvaged), HackRF, Airspy, or similar
- 2–4 GB RAM minimum; 4+ GB recommended for smooth spectrum display
- An antenna: a simple dipole, monopole, or even a piece of wire works for VHF/UHF
- Git and a C++ compiler (gcc/clang)
- About 30–60 minutes for compilation on a typical machine
Step 1: Install Build Dependencies
Your system needs GNU Radio 3.8–3.10, Qt 5 or Qt 6, cmake, and hardware drivers. Install them from your distribution’s package manager.
On Debian/Ubuntu:
sudo apt-get update
sudo apt-get install -y \
cmake git build-essential \
libgnuradio-dev gnuradio \
libqt5core5a libqt5gui5 libqt5widgets5 libqt5network5 libqt5svg5 \
qtbase5-dev qtbase5-dev-tools \
libpulse-dev portaudio19-dev \
libboost-all-dev
For RTL-SDR hardware support, also install:
sudo apt-get install -y librtlsdr-dev librtlsdr0 rtl-sdr
For other hardware (HackRF, Airspy, etc.), install the relevant drivers from their upstream repositories.
On macOS (Homebrew):
brew install cmake gnuradio qt5 boost
brew install librtlsdr # for RTL-SDR support
Step 2: Install gr-osmosdr (SDR Hardware Abstraction)
gr-osmosdr is the GNU Radio module that interfaces with SDR hardware. Clone and compile it:
git clone https://gitea.osmocom.org/sdr/gr-osmosdr.git
cd gr-osmosdr
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
sudo make install
sudo ldconfig
cd ../..
Step 3: Run volk_profile (Optional but Recommended)
Before compiling GQRX, run the VOLK profiler to detect CPU-specific optimizations. This can give a 2–10× performance boost on spectrum rendering:
volk_profile
Let it complete; it will take a few minutes.
Step 4: Clone and Compile GQRX
git clone https://github.com/gqrx-sdr/gqrx.git gqrx.git
cd gqrx.git
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
On systems with aggressive compiler defaults, you may need to force -O2 optimization:
export CXXFLAGS=-O2
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
Compilation typically takes 5–15 minutes depending on your CPU and RAM.
Step 5: Install and Test
sudo make install
sudo ldconfig
Verify your SDR device is recognized by the kernel:
rtl_test -t
You should see output like:
Found 1 device(s):
0: Realtek, RTL2832U, SN: 00000001
If your device isn’t found, check udev rules or kernel driver conflicts (mentioned in the README).
Step 6: Launch GQRX
gqrx
On first launch, GQRX opens a device configuration dialog. Select your SDR device from the dropdown (e.g., “RTL-SDR Stick”). Click OK.
The main window shows:
- Frequency dial (top left): tune from ~24 MHz to ~1.7 GHz depending on your hardware
- Spectrum display (center): real-time FFT of received signals
- Audio output (bottom): AM/FM/SSB demodulation
- Recording controls: save raw IQ data or audio
Step 7: Tune and Listen
- Set your Mode to FM (lower left).
- Tune the Frequency to a local FM radio station (e.g., 88.5 MHz in the US).
- Adjust Gain (right panel) until you see signals in the spectrum.
- Click the speaker icon to enable audio output.
- Fine-tune with the Frequency offset slider.
You should hear audio from the station. Experiment with AM (for shortwave), SSB (for amateur radio), or FFT-only mode (no audio, just spectrum analysis).
Step 8: Load and Save Configurations
GQRX stores device and session configs in ~/.config/gqrx/. You can load multiple profiles via the GUI or command line:
gqrx -c my_config_name
Useful for switching between FM broadcast, amateur radio, and weather satellite modes without reconfiguring every time.
Advanced: Pipe Data to External Tools
GQRX supports network sockets for remote control and data streaming. You can pipe demodulated audio or raw IQ data to other GNU Radio flowgraphs, decoders (like NOAA weather satellites via GQRX + gr-noaa), or logging systems. See the official tutorials at https://gqrx.dk/ for flowgraph examples.
Keep It Off the Internet
GQRX listens on localhost by default and is not a network service. However, if you enable remote control via UDP or TCP sockets, keep those bindings to 127.0.0.1 or your LAN subnet. Never expose GQRX to the public internet—it’s a monitoring tool for your own use.
Troubleshooting
Device not found:
- Verify the USB device is plugged in:
lsusb | grep Realtek - Check udev rules:
sudo udevadm control --reload-rules && sudo udevadm trigger - Test with
rtl_testor device-specific tools (e.g.,airspy_rxfor Airspy)
Poor performance or stuttering:
- Run
volk_profileto enable CPU optimizations - Reduce FFT size (Receiver → FFT size) to lower CPU load
- Close other applications
- Increase system RAM or use a faster CPU
No audio:
- Ensure audio output is enabled (speaker icon in GQRX)
- Check system volume and audio device settings
- Verify you’re tuned to an actual signal (look at the spectrum)
Is It Worth It?
If you have old WiFi hardware lying around and curiosity about radio signals, yes. A salvaged RTL-SDR dongle costs nothing; GQRX is free; and the learning curve is gentle. You get a working spectrum analyzer and radio receiver for the cost of time. If you’re buying new hardware, a $30 RTL-SDR dongle is the cheapest entry point to SDR. The real value is in the skills: understanding modulation, signal processing, and how radio actually works. For a homelab, it’s a solid addition to your monitoring and experimentation toolkit.
Sources
Related video
New self-hosted AI & homelab shorts, daily.
Subscribe on YouTubeRelated guides
Turn an old webcam into an AI security camera with Frigate
Run Frigate NVR on a spare PC to detect people, cars, and animals in real-time from cheap IP cameras or old USB webcams. Local processing, no cloud, integrates with Home Assistant.
Turn a $15 Android TV Box into an Armbian Linux Server
Flash Armbian on Amlogic S905/S922 TV boxes to run Docker, Pi-hole, and other services. Boot from USB first—eMMC flashing can brick it.
Run macOS Binaries on Linux ARM with Kakehashi
Use Kakehashi to execute native macOS applications on Linux ARM64 hardware, cutting Apple hardware costs while keeping your workflow intact.