InstallingGR

From GNU Radio
Revision as of 22:26, 3 November 2022 by PaulKYoung (talk | contribs) (Moved the Linux-specific installation information to LinuxInstall)
Jump to navigation Jump to search
Beginner Tutorials

Introducing GNU Radio

  1. What is GNU Radio?
  2. Installing GNU Radio
  3. Your First Flowgraph

Flowgraph Fundamentals

  1. Python Variables in GRC
  2. Variables in Flowgraphs
  3. Runtime Updating Variables
  4. Signal Data Types
  5. Converting Data Types
  6. Packing Bits
  7. Streams and Vectors
  8. Hier Blocks and Parameters

Creating and Modifying Python Blocks

  1. Creating Your First Block
  2. Python Block With Vectors
  3. Python Block Message Passing
  4. Python Block Tags

DSP Blocks

  1. Low Pass Filter Example
  2. Designing Filter Taps
  3. Sample Rate Change
Install Quickstart
(Refer to the rest of this page for more OS and installation options)
Ubuntu 22.04
  1. sudo apt-get install gnuradio
v3.10.1
Ubuntu 20.04
  1. sudo add-apt-repository ppa:gnuradio/gnuradio-releases
  2. sudo apt-get update
  3. sudo apt-get install gnuradio python3-packaging
v3.10.4
Windows
  1. Install the latest Radioconda installer
  2. Launch "GNU Radio Companion" from the Start menu
v3.10.4
macOS
  1. Install Homebrew
  2. brew install gnuradio
v3.10.4


Types of Installation Methods

The recommended way to install GNU Radio on most platforms is using already available binary packages. Find your platform below in the From Binaries section for instructions on how to get GNU Radio through your regular package manager (e.g. Ubuntu PPA Installation), or visit the Conda Installation page for instructions on how to use the Conda package manager to install GNU Radio on any Linux distribution, macOS, or Windows. For some platforms there are no binaries provided by available package managers or the GNU Radio project. In these cases please contact the maintainer of the package manager or the GNU Radio project to find a sensible way to provide binaries for your platform.

In addition to using binaries, GNU Radio can be installed:

  1. From source (for those who want full control)
  2. Using PyBOMBS (for those who want it built from source and/or installed to a specific directory using a script)

Linux

See the Linux install guide

Windows

See the Conda install guide or radioconda to install GNU Radio 3.8 or newer on Windows.

If you need to install GNU Radio from source refer to the Windows install guide.

Note: GNU Radio support on Windows is improving significantly but remains less tested and there are known problems and even significant bugs which affect regular usage of GNU Radio Companion. Please report bugs on the GitHub Issues page and if you have Windows development experience please consider investigating some of the known issues.

Mac OS X

Refer to the Mac OS X install guide page.

Using PyBOMBS

PyBOMBS used to be the go-to method for building GNU Radio, UHD, and various Out of Tree (OOT) modules from source and then installing them into an isolated directory rather than system-wide, not unlike a Python virtualenv. We are no longer including PyBOMBS as a recommended method of installing GNU Radio, unless you want to play around with old versions (e.g. GR 3.7, 3.8, and OOTs of matching version). The PyBOMBS documentation is in the PyBOMBS README.

VMs and Live Images

Over the years a number of Live Images and VMs have been created. There are currently no official versions but here are some current options:

  • Instant GNU Radio A customizable, programmatically generated VM and live environment for GNU Radio.
  • UbuntuVM An Ubuntu 20.04 virtual machine image with GNU Radio 3.8.2.0, Fosphor, GQRX, and several other useful pieces of software. (Created using Instant GNU Radio)

OK, it's installed, what now?

If the installation worked without any trouble, you're ready to use GNU Radio! If you have no idea how to do that, the best place to start is with the Tutorials.

Optionally, you may run volk_profile on your terminal to help libvolk to determine the optimal kernels (may speed up GNU Radio).