QtRadio Installation

Installation on Linux

The instructions below are for Debian based distributions like Ubuntu but you should be able to compile on any Linux distribution with the correct libraries installed.

Installation from PPA

For Ubuntu Users there is a ppa for the binaries produced from the master branch, maintained by Andrea. Supported versions are: Ubuntu Lucid, Ubuntu Natty, Ubuntu Oneiric, and known to work, Linux Mint 11

At the time of this writing, (Nov 12 2011) PPA release 1.7 is online.

This is the easiest way to install QtRadio, dspserver and the softrock server. The code base is taken from the master branch and in the "about" panel there is some additional information in order to show where the source is coming from.

text mode installation

In order to add this repository to your apt system (U11.10, U11.04, U10.04) enter the following commands in a terminal.

sudo add-apt-repository ppa:andrew-montefusco/ghpsdr3
sudo apt-get update
sudo apt-get install ghpsdr3

graphical installation

• Start the Synaptic Package Manager
• From the menu Settings select Repositories, a dialog box Software Sources will be shown
• On the first pane Ubuntu Software check the Community-maintaned Open Source Software (universe) tick
• On the second pane Other Software click on the add button, and, in the dialog software-properties-gtk enter
  ppa:andrew-montefusco/ghpsdr3
• Back to the Software sources dialog, press Close
• Press the Reload button on the top bar of main window
• Press the Section button (bottom left pane) and next select Amateur Radio and, on the right pane, the ghpsdr3 package
• Press Apply button on the top bar: answer yes, if so requested, in order to install the required dependencies

You will then find the QtRadio app in the Applications, Internet menu. If you have the Hamradio menu installed you will find it there also.
Subsequently you can use the Ubuntu software update process to update to the latest ppa version.
More information about Andrea's PPA is at https://launchpad.net/~andrew-montefusco/+archive/ghpsdr3

Installation from Git

Installing from git involves building or compiling from source. This is required if you want to use one of the various branches to work the "bleeding edge" branches like Alex's rxtx-event branch where the current (Nov 12 2011) TX work is being done. The PPA install is never more than a few days behind master so there is not much to gain from building from git unless you want to work with the source code your self.

Installing compiler and autotool

First off, install the compiler; depending on which distribution are you using, some or all of this stuff could be already installed:

sudo apt-get install make gcc g++
sudo apt-get install autoconf automake autotools-dev libtool

Installing Git

You will need the following build dependencies installed.

sudo apt-get install libqt4-opengl-dev
sudo apt-get install glutg3-dev
sudo apt-get install libusb-0.1-4
sudo apt-get install libusb-dev
sudo apt-get install libfftw3-dev
sudo apt-get install portaudio19-dev
sudo apt-get install libpulse-dev
sudo apt-get install libsamplerate0-dev
sudo apt-get install libusb-1.0-0-dev
sudo apt-get install libconfig8-dev
sudo apt-get install libtool
sudo apt-get install qtmobility-dev

Now you can install git

sudo apt-get install git

Cloning the repository

How to build the latest rxtx-event branch on Ubuntu 11.04

First a new libevent will need to be downloaded and installed, then the actual QtRadio source can be downloaded and built.

Obtaining an up-level libevent library

For the rxtx-event branch of the software, you will also need a version of libevent that is newer than what is available from the Ubuntu distribution. Go to synaptic and completely remove the stock libevent (v1.4) from Ubuntu. (Completely remove is an uninstall option in Synaptic. Additional dependent libraries may also be removed)

Then download the new version from:

http://libevent.org/

libevent-2.0.15-stable.tar.gz

wget https://github.com/downloads/libevent/libevent/libevent-2.0.15-stable.tar.gz

Move the tarball from the Downloads directory to a working directory. A suggestion is to create a src directory within your home directory and move it there. Uncompress and follow the instructions to build and install:

$ tar -zxvf libevent-2.0.15-stable.tar.gz

$ cd libevent-2.0.15-stable

$ ./configure
$ make
$ sudo make install
$ sudo ldconfig

Installing codec2 low bit rate audio encoding and decoding

We are adding a low bit rate audio codec called codec 2 to QtRadio/dspserver. You need to download and build the codec2 library. See:

http://www.rowetel.com/blog/?page_id=452

svn co https://freetel.svn.sourceforge.net/svnroot/freetel/codec2
cd codec2
autoreconf -i
./configure
make
sudo make install
sudo ldconfig

Building the rxtx-event branch

This branch is the latest code that contains both RX and TX capability.

Create a new directory or cd to the ~/src directory created for libevent and cd into it.

$ git clone git://github.com/alexlee188/ghpsdr3-alex

It will take a minute to download. cd into the new directory ghpsdr3-alex:

$ cd ghpsdr3-alex
$ git checkout rxtx-event

You are now working with Alex's latest and greatest!

$ autoreconf -i
$ ./configure
$ make all
$ sudo make install

(If you do not want to actually install the executable binaries, skip the sudo make install and just cd into the following directories and run them from there)

Terminal 1
$ cd ghpsdr3-alex/trunk/src/softrock
$ ./softrock ...options ...

Terminal 2
$ cd ghpsdr3-alex/trunk/src/dspserver
$ ./dspserver  ..options...

Terminal 3
$ cd ghpsdr3-alex/trunk/src/QtRadio
$ ./QtRadio

Refresh to a Newer Version

To pull a new version to build

$ git pull
$ make all
$ sudo make install

Installation on Windows

QtRadio, the client, is available on Windows for RX. A zip can be downloaded from: http://napan.com/ve9gj/qtradio.zip

Unzip to any folder and run the qtradio.exe file. It does not need an actual install, just the included dll files in the same folder.