1<p align="center"> 2<img src="https://github.com/gnuradio/gnuradio/blob/master/docs/gnuradio.png" width="75%" /> 3</p> 4 5[![Build](https://shield.lwan.ws/img/p5UKbS/weekly_runner)](https://ci.gnuradio.org/buildbot/#/) 6![Version](https://img.shields.io/github/tag/gnuradio/gnuradio.svg) 7[![AUR](https://img.shields.io/github/license/gnuradio/gnuradio)](https://github.com/gnuradio/gnuradio/blob/master/COPYING) 8[![Docs](https://img.shields.io/badge/docs-doxygen-orange.svg)](https://www.gnuradio.org/doc/doxygen/) 9[![Packaging status](https://repology.org/badge/tiny-repos/gnuradio.svg)](https://repology.org/project/gnuradio/badges) 10 11GNU Radio is a free & open-source software development toolkit that 12provides signal processing blocks to implement software radios. It can 13be used with readily-available, low-cost external RF hardware to create 14software-defined radios, or without hardware in a simulation-like 15environment. It is widely used in hobbyist, academic, and commercial 16environments to support both wireless communications research and real-world 17radio systems. 18 19Please visit the GNU Radio website at https://www.gnuradio.org/ and the 20wiki at https://wiki.gnuradio.org/. Bugs and feature requests are 21tracked on GitHub's [Issue Tracker](https://github.com/gnuradio/gnuradio/issues). 22If you have questions about GNU Radio, please search the **discuss-gnuradio** 23mailing list [archive](https://lists.gnu.org/archive/html/discuss-gnuradio/), 24as many questions have already been asked and answered. Please also 25[subscribe](https://lists.gnu.org/mailman/listinfo/discuss-gnuradio) to 26the mailing list and post your new questions there. 27 28 29## How to Install GNU Radio 30 31### Prebuilt Binaries 32 33The recommended way to install GNU Radio on most platforms is using available binary package distributions. 34 35The following command is for Debian, Ubuntu, and derivatives. It will install Release 3.7 with Python2. 36 37 sudo apt install gnuradio 38 39For other operating systems, see [Installing from Binaries](https://wiki.gnuradio.org/index.php/InstallingGR#From_Binaries) 40 41### PyBOMBS 42 43PyBOMBS is good at building GNU Radio, UHD, and various Out of Tree (OOT) modules from source and then installing into a specified user directory rather than in the system files. PyBOMBS detects the user's Operating System and loads all of the prerequisites in the first stage of the build. 44 45For a quick start, open a terminal window and enter the following commands. This will install Release 3.8 with Python3. 46 47 sudo -H pip3 install PyBOMBS 48 pybombs auto-config 49 pybombs recipes add-defaults 50 pybombs prefix init ~/gnuradio -R gnuradio-default 51 52<b>Wait</b>. The terminal will show the progress. 53 54To run GNU Radio Companion, enter: 55 56 pybombs run gnuradio-companion 57 58Complete PyBOMBS instructions are in the [PyBOMBS README](https://github.com/gnuradio/pybombs#pybombs). 59 60### From Source 61 62Complete instructions for building Gnuradio from source code are detailed in 63[Installing GR From Source](https://wiki.gnuradio.org/index.php/InstallingGR#From_Source). 64 65## Legal Matters 66 67Some files have been changed many times throughout the years. Copyright 68notices at the top of source files list which years changes have been 69made. For some files, changes have occurred in many consecutive years. 70These files may often have the format of a year range (e.g., "2006 - 2011"), 71which indicates that these files have had copyrightable changes made 72during each year in the range, inclusive. 73