gqrx is an open source software defined radio receiver (SDR) powered by the GNU Radio and the Qt graphical toolkit. It supports multiple SDR hardware devices, including (but not limited to) the RTL-SDR, HackRF, and Airspy. A complete list of supported hardware can be found at https://gqrx.dk/supported-hardware.
Notable features include AM, SSB, CW, and (wide) FM demodulation, spectrum plots and waterfalls, and the ability to record and stream audio output. A more complete list of features can be found on the gqrx website: https://gqrx.dk/
If using an RTL-SDR, the kernel must be configured to blacklist the rtl2832 module, as the normal DVB-T driver is not compatible for its use as an SDR. More information regarding this can be found on the RTL-SDR wiki page.
USE flags for gqrx itself are as follows:
USE flags for net-wireless/gqrx Software defined radio receiver powered by GNU Radio and Qt
||Use audio support from net-wireless/gnuradio|
||Add support for the crossplatform portaudio audio API|
||Add support for PulseAudio sound server|
It is important to specify the correct USE flags for the net-wireless/gr-osmosdr dependency, or else gqrx will not find your SDR device:
USE flags for net-wireless/gr-osmosdr GNU Radio source block for OsmoSDR and rtlsdr and hackrf
||Build with Airspy support through net-wireless/airspy|
||Build with Nuand BladeRF support through net-wireless/bladerf|
||Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally|
||Build with Great Scott Gadgets HackRF support through net-libs/libhackrf|
||Enable support for I/Q balancing using gr-iqbal through net-wireless/gr-iqbal|
||Add optional support/bindings for the Python language|
||Build with Realtek RTL2832U support through net-wireless/rtl-sdr|
||Enable support for SDRplay devices through net-wireless/sdrplay|
||Build with SoapySDR support through net-wireless/soapysdr|
||Build with Ettus Research USRP Hardware Driver support through net-wireless/uhd|
||Build with xtrx Hardware Driver support through net-wireless/libxtrx|
For example, if one has an RTL-SDR, the following can be used:
emerge --ask net-wireless/gqrx
- ~/.config/gqrx/default.conf - User configuration file for the configured SDR device.
The above file will be created on first launch when selecting the SDR device and associated options. If the supplied config results in an error, gqrx will detect this and let the user re-specify their config on the next launch.
Start gqrx's graphical interface as follows: gqrx
Additional options can be seen with -h/--help:
Controlport disabled Gqrx software defined radio receiver 2.12 Command line options: -h [ --help ] This help message -s [ --style ] arg Use the give style (fusion, windows) -l [ --list ] List existing configurations -c [ --conf ] arg Start with this config file -e [ --edit ] Edit the config file before using it -r [ --reset ] Reset configuration file
SDR device not listed
If the SDR device necessary is not listed, then it is possible that net-wireless/gr-osmosdr was not compiled with the correct USE flag(s). Launch gqrx from the command line and look for the following line:
... built-in source types: ... ...
For reference, a build of gr-osmosdr with support for most SDR devices will look like this:
... built-in source types: file osmosdr fcd rtl rtl_tcp plutosdr miri hackrf bladerf rfspace airspy airspyhf soapy redpitaya ...
Check the USE flags that are set for the net-wireless/gr-osmosdr package to ensure the correct one(s) are set for the needed devices.
emerge --ask --depclean --verbose net-wireless/gqrx