Main Page

Example 2 meter NBFM receiver

GNU Radio is a free & open-source software development toolkit that provides signal processing blocks to implement software radios. It can be used with readily-available low-cost external RF hardware to create software-defined radios, or without hardware in a simulation-like environment. It is widely used in hobbyist, academic and commercial environments to support both wireless communications research and real-world radio systems.

GNU Radio is licensed under the GNU General Public License (GPL) version 3 or later. All of the code is copyright of the Free Software Foundation.

Getting started

If you've never touched GNU Radio before, these pages will get you started with a running installation of GNU Radio and will show you how to take your first steps with this software radio tool.

• A Newbie's Guide to GNU Radio - A beginner's overview.
• What is GNU Radio and why do I want it? - Read this if you really have no idea what this project is about.
• Installing GNU Radio - This will explain all the steps to get a working installation of GNU Radio.
• Tutorials - The GNU Radio Academy is a complete course from beginner to advanced user.
• The Comprehensive GNU Radio Archive Network (CGRAN) - A list of 3rd party GNU Radio apps.
• Frequently Asked Questions - Check this page before asking questions on the mailing list.

Documentation

• User Documentation
  1. The Usage Manual contains information about various aspects of GNU Radio not specific to a certain block.
  2. List of Blocks (or just wiki search the block name)
• Developer Documentation
  1. Our C++ Manual and API Reference includes documentation targeted for developers. It is based on Doxygen, using markup comments in the public header files.
  2. 3.8 to 3.9 OOT Module Porting Guide
  3. 3.7 to 3.8 OOT Module Porting Guide
• Tutorials - Several tutorials for varying skill levels.

Community & Communicating

There's a nice community of people involved in GNU Radio. Here's some pointers on how to connect with us.

• Our Code of Conduct describes our expectations for community participation.
• Asking Questions and Reporting Errors - We're helpful people, but we expect you to try to help yourself first.
• Mailing lists - Where most of the communication happens, but please read the previous article first.
• How to get involved - Do you want to help with the project, or simply become part of the GNU Radio Community? Read this!
• Chat - For a more real-time interaction, come join our chat rooms on Matrix
• More GNU Radio on the web and in social media
• GNU Radio organizing members
• Working Groups - Communities of interest for various aspects of the GNU Radio ecosystem.
• DevelopersCalls - The developers have monthly VoIP conferences which are open to join.
• The GNU Radio Conference (GRCon) - archive pages: 2018 | 2017 | 2016 | 2015 | 2014 | 2013 | 2012 | 2011
• Archive of Hack Fests and miscellaneous Presentations
• We have a Calendar containing project calls and other events

Developing GNU Radio

Using GNU Radio is nice, but the real fun comes with developing new components for GNU Radio or actually changing the core itself. If you want to write some code, read these articles first. Some of the tutorials are also relevant.

• Development Information for Contributors
• Coding and style guidelines for GNU Radio
• Block structure guide
• API and Code Version Changes
• An overview of the GNU Radio scheduler
• YouTube feed from Ettus Research featuring demos and howtos for using GNU Radio and USRPs.
• Embedded Development with GNURadio
• Summer of Code Programs - Student Programs from Google (GSoC) and ESA (SOCIS), see Summer of Code Project Ideas List

Hardware

Hardware is strictly not part of GNU Radio, which is purely a software library. However, developing radio and signal processing code is even more fun when using hardware to actually transmit and receive, and GNU Radio supports several radio front-ends, either natively or through additional out-of-tree modules.

For a list of supported devices, see our Hardware page.

Further information and 3rd party extensions

There's more stuff to be found for GNU Radio on the web. Check these pages to find tutorials, code and other information on GNU Radio.

• Suggested Reading - A list of non-GNU Radio-related literature, including good introductions to signal processing, radio engineering and software development.
• Documentation and Videos for GNU Radio on other servers
• Real world users and Commercial Support/Training
• Selected Academic papers involving GNU Radio
• GQRX - Very nice spectrum analysis tool, powered by GNU Radio