GNU Radio is a free & open-source signal processing runtime and signal processing software development toolkit. Originally developed for use with software-defined radios and for simulating wireless communications, it's robust capabilities have led to adoption in hobbyist, academic, and commercial environments. GNU Radio has found use in software-defined radio, digital communications, nuclear physics, high- energy particle physics, astrophysics, radio astronomy and more!
# Ensure PyQt5 and other dependencies are installed
pip install QDarkStyle qtpy
# If you want to run tests
pip install pytest-qt pyautogui
# Build and install as usual (described below) and then run
gnuradio-companion --qt
The next major release of GNU Radio, GNU Radio 4.0, is currently under active development. The effort is being spearheaded by FAIR (The Facility for Anti-Proton and Ion Research), part of GSI in Germany. Development of that version is currently taking place under their GitHub organization, here.
The recommended way to install GNU Radio on most platforms is using available binary package distributions.
The following command is for Debian, Ubuntu, and derivatives. Consult your distribution information to obtain the version of GNU Radio which is included.
sudo apt install gnuradio
For other operating systems and versions, see Quick Start
For Ubuntu, the latest builds (both released and pulled from master branch) are maintained as PPAs (Personal Package Archives) on launchpad.net. Be sure to uninstall any previously installed versions of gnuradio first. See UnInstall GR.
Platform-specific guides and Cross-platform guides are described in Other Installation Methods.
Complete instructions for building GNU Radio from source code are detailed in Installing From Source.
We are no longer recommending PyBOMBS to install modern versions of GNU Radio.
If you find GNU Radio useful and would like to support its development, you can make a donation. Your contributions help ensure ongoing improvements and maintenance. Thank you for your support!
Some files have been changed many times throughout the years. Copyright notices at the top of source files list which years changes have been made. For some files, changes have occurred in many consecutive years. These files may often have the format of a year range (e.g., "2006 - 2011"), which indicates that these files have had copyrightable changes made during each year in the range, inclusive.