Home - ruchirguitar/RTLSDR-Airband GitHub Wiki

RTLSDR-Airband โ€” this fork

This is ruchirguitar/RTLSDR-Airband, a personal fork of rtl-airband/RTLSDR-Airband. The demodulation engine (src/) is unmodified โ€” for the core engine, its config file format, build flags, and general reference, see upstream's own wiki, which still applies here.

What this fork adds is gui/: a local web app for running the engine as a frequency recorder โ€” any AM/NFM frequency your receiver's bandwidth covers โ€” without hand-editing libconfig files.

Pages in this wiki

  • Frequency Recorder GUI โ€” what it does, every tab explained, live listening, the recordings archive.
  • Troubleshooting โ€” the handful of real gotchas we hit getting this running on actual hardware, and what fixed them.

Quick start

git clone https://github.com/ruchirguitar/RTLSDR-Airband.git
cd RTLSDR-Airband

# build the engine - -DNFM=ON is required for FM support
sudo apt-get install build-essential cmake pkg-config libmp3lame-dev libshout3-dev 'libconfig++-dev' libfftw3-dev
mkdir build && cd build && cmake -DNFM=ON ../ && make && sudo make install
cd ..

# run the GUI
cd gui && pip install -r requirements.txt && python3 app.py

Open http://127.0.0.1:5050.

Responsible & legal use

This tool can record or stream whatever your receiver picks up on the frequencies you configure. Radio recording laws vary by country and by transmission type โ€” it's on you to know and follow the rules that apply where you are. See the in-app Help tab, or Frequency Recorder GUI, for more.

Credits

๐Ÿ‡ฎ๐Ÿ‡ณ Built by Ruchir ยท VU22PR, India. GIAR โ€” Gujarat Institute of Amateur Radio.