This page describes the installation of gr-satellites on (K)Ubuntu version 19.04


$sudo apt-get install gnuradio --> will install version plus dependencies

$sudo apt-get install gr-osmosdr --> will install the block to access a RTL-SDR stick

$sudo apt-get install xterm --> used by GNURadio


After installing the things above you should be able to start GNU Radio Companion from menu or command line.


$sudo apt-get install git --> will install git for cloning git repositories

$mkdir src

$cd src

$git clone --> the good stuff

$git clone --> needed for gr-satellites

$cd libfec



$sudo make install

$cd ..

$sudo apt-get install python-pip --> needed to install gr-satellites dependencies

$pip install construct --> installs this gr-satellites dependency

$pip install requests --> make sure it has the trailing 's'

$sudo apt-get install swig --> installs this gr-satellites dependency $sudo apt-get install cmake --> if not installed already

$cd gr-satellites

$mkdir build

$cd build

$cmake ..


$sudo make install

$sudo ldconfig

$cd ..

$./ --> blocks needed for certain gr-satellites flow graphs. Don't forget this step and be patient because it will take a while to complete.


Now you can start GNU Radio Companion and open a flow graph from the source directory of gr-satellites/apps folder. Compile and execute it.

After you execute a gr-satellites flow graph there should be a terminal window popping up. If there isn't then do either one of the following two options.


To change system wide:

$cd /etc/gnuradio/conf.d

$sudo nano grc.conf --> this will open the file with the nano editor

Append the line that says "xterm_executable =" with "/usr/bin/xterm"

To save and exit use: Ctrl-X, then Y, then Enter.


To change for the current user only:

$cd .gnuradio

$nano config.conf --> this will create the file and open it

In the newly created file make the following entry...


xterm_executable = /usr/bin/xterm

To save and exit: Ctrl-X, then Y, then Enter.

Final step: start GQRX, activate the UDP audio stream and start decoding telemetry.


Latest revision: Sept 23, 2019