Software defined radio receiver powered by GNU Radio and Qt.
Gqrx is an open source software defined radio (SDR) receiver implemented using
GNU Radio and the Qt GUI toolkit.
Currently it works on Linux and Mac with hardware supported by gr-osmosdr,
including Funcube Dongle, RTL-SDR, Airspy, HackRF, BladeRF, RFSpace, USRP and
SoapySDR.
Gqrx can operate as an AM/FM/SSB receiver with audio output or as an FFT-only
instrument. There are also various hooks for interacting with external
applications using network sockets.
Gqrx is distributed as a source code package and binaries for Linux and Mac.
Many Linux distributions provide gqrx in their package repositories.
Alternate Mac support is available through MacPorts and Homebrew.
Windows support is available through radioconda.
It is strongly recommended to run the volk_profile utility before
running gqrx. This will detect and enable processor-specific optimisations and
will in many cases give a significant performance boost.
The first time you start gqrx it will open a device configuration dialog.
Supported devices that are connected to the computer are discovered
automatically and you can select any of them in the drop-down list.
If you don’t see your device listed in the drop-down list it could be because:
You can test your device using device specific tools, such as rtl_test,
airspy_rx, hackrf_transfer, qthid, etc.
Gqrx supports multiple configurations and sessions if you have several devices
or if you want to use the same device under different configurations. You can
load a configuration from the GUI or using the -c command line argument. Seegqrx --help for a complete list of command line arguments.
Tutorials and howtos are being written and published on the website
https://gqrx.dk/
See the bug tracker on Github: https://github.com/gqrx-sdr/gqrx/issues
There is a Google group for discussing anything related to Gqrx:
https://groups.google.com/g/gqrx
This includes getting help with installation and troubleshooting. Please
remember to provide detailed description of your problem, your setup, what
steps you followed, etc.
Please stick around and help others with their problems. Otherwise, if only
developers provide user support there will be no more time for further
development.
The source code is hosted on Github: https://github.com/gqrx-sdr/gqrx
To compile gqrx from source you need the following dependencies:
Gqrx can be compiled from within Qt Creator or in a terminal:
For command line builds:
On some systems, the default cmake release builds are "over-optimized" and perform poorly. In that case try forcing -O2 using
- $ git clone https://github.com/gqrx-sdr/gqrx.git gqrx.git
- $ cd gqrx.git
- $ mkdir build
- $ cd build
- $ cmake ..
- $ make
before the cmake step. For Qt Creator builds:
- export CXXFLAGS=-O2
- $ git clone https://github.com/gqrx-sdr/gqrx.git gqrx.git
- $ cd gqrx.git
- $ mkdir build
- Start Qt Creator
- Open gqrx.git/CMakeLists.txt file
- At the dialog asking for build location, select gqrx.git/build
- click continue
- If asked to choose cmake executable, do so
- click continue
- click the run cmake button
- click done
- optionally, on the Projects page, under Build Steps/Make/Additional arguments,
- enter -j4 (replacing 4 with the number of cores in your CPU).
- Use Qt Creator as before
Debug logging can be enabled by setting the QT_LOGGING_RULES environment
variable:
QT_LOGGING_RULES="*.debug=true;plotter.debug=false;qt.*.debug=false" gqrx
To turn on plotter debugging as well, use the following command:
QT_LOGGING_RULES="*.debug=true;qt.*.debug=false" gqrx
Gqrx is designed and written by Alexandru Csete OZ9AEC, and it is licensed
under the GNU General Public License.
Some of the source files were adapted from Cutesdr by Moe Weatley and these
come with a Simplified BSD license.
The following people and organisations have contributed to gqrx:
Some of the icons are from:
Also thanks to Volker Schroer and Alexey Bazhin for bringing Funcube Dongle
Pro+ support to GNU Radio and Gqrx.
Let me know if somebody is missing from the list.
Alex OZ9AEC