Skip to content

GNU Radio Installation Instructions (for desktop or notebook)

William Dye edited this page Aug 31, 2013 · 1 revision

NOTE: These instructions assume you are installing GNU Radio on a Linux distribution (Ubuntu, Debian, Mint, etc.) on a laptop or desktop. These instructions should NOT be used to install GNU Radio on a Raspberry Pi.

  1. Install the Git command line client with a command such as:

    $ sudo apt-get install git

  2. Change to the directory where you want to check out the PyBOMBS repository. PyBOMBS is a dependency manager and installer for various software packages. The repository will be checked out into a subdirectory called pybombs. You should be able to use the following command:

    $ git clone git://github.com/pybombs/pybombs.git

  3. Change to the directory where you checked out PyBOMBS:

    $ cd pybombs

  4. Run the PyBOMBS configuration target:

    $ ./pybombs config

    You should not have to change any of the default settings. Just hit Enter at each prompt.

  5. Install GNU Radio using PyBOMBS. You will be prompted to select the directory in which to install the software. NOTE: This step will take a long time:

    $ sudo ./pybombs install gnuradio

  6. Edit your .bashrc to export necessary environment variables. For this step, you will need to know where GNU Radio was installed. If you used PyBOMBS, this will be a directory called target; otherwise, this is likely the directory /usr/local. I will call this directory /path/to/gnuradio. Use your favorite editor (vi, nano, gedit, etc.) and add the following lines to ~/.bashrc:

    PYTHONPATH=$PYTHONPATH:/path/to/gnuradio/lib/python2.7/dist-packages
    export PYTHONPATH
    
    LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/to/gnuradio/lib
    export LD_LIBRARY_PATH
    
    PATH=$PATH:/path/to/gnuradio/bin
    export PATH
    
  7. Restart your terminal for the environment variable changes to take effect. (You will probably have to type exit in your current terminal and then launch a new one.)

  8. Verify that the installation succeeded. Typing:

    $ which gnuradio-companion

    should show:

    /path/to/gnuradio/bin/gnuradio-companion

    You should be able to import the gnuradio module from the Python interpreter:

    $ python
    Python 2.7.3 (default, Jan 2 2013, 16:53:07)
    [GCC 4.7.2] on linux2
    Type "help", "copyright", "credits" or "license" for more information.
    >>> from gnuradio import *
    >>> quit()
    

    If you do not get an error from the import statement, you are good to go.

  9. Launch GRC (GNU Radio Companion):

    $ gnuradio-companion

    The GRC graphical user interface should appear.