homelabaiprivacy

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 ../..

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

  1. Set your Mode to FM (lower left).
  2. Tune the Frequency to a local FM radio station (e.g., 88.5 MHz in the US).
  3. Adjust Gain (right panel) until you see signals in the spectrum.
  4. Click the speaker icon to enable audio output.
  5. 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_test or device-specific tools (e.g., airspy_rx for Airspy)

Poor performance or stuttering:

  • Run volk_profile to 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.

Related video

New self-hosted AI & homelab shorts, daily.

Subscribe on YouTube

Related guides

← All guides