QSSTV  9.4

Warning: from version 9.1.1 and higher, Jasper library is dropped and openjpeg is used We need openjpeg2 (e.g. libopenjpeg2.1 or higher) and not libopenjpeg 1.5

Step 1: Prerequisites

Before you can compile QSSTV make sure that you have installed the following software

  • pkg-config
  • g++
  • libfftw3-dev
  • qt5-default
  • hamlib-dev or libhamlib++-dev
  • libasound2-dev
  • libpulse-dev
  • libopenjp2-7
  • libopenjp2-7-dev
  • libv4l-dev

On Ubuntu, Debian or Mint you can type:

sudo apt-get install pkg-config g++ libfftw3-dev qt5-default libpulse-dev
sudo apt-get install libasound2-dev  libv4l-dev
sudo apt-get install libopenjp2-7 libopenjp2-7-dev

On older distributions:

sudo apt-get install hamlib-dev

On newer distributions

sudo apt-get install libhamlib++-dev

If you don't find libopenjp2-7 you can download it with the follwing commands if you're running a Debian derived distribution:

wget http://ftp.de.debian.org/debian/pool/main/o/openjpeg2/libopenjp2-7_2.1.0-2_i386.deb
wget http://ftp.de.debian.org/debian/pool/main/o/openjpeg2/libopenjp2-7-dev_2.1.0-2_i386.deb


wget http://ftp.de.debian.org/debian/pool/main/o/openjpeg2/libopenjp2-7_2.1.0-2_amd64.deb
wget http://ftp.de.debian.org/debian/pool/main/o/openjpeg2/libopenjp2-7-dev_2.1.0-2_amd64.deb

and install the packages with the package manager or simply by double clicking on them. First install the library and then the development package. This is the case for example for Linux Mint 17.3.

For specific instructions on installation on different distributions: have a look at the FAQ html http://users.telenet.be/on4qz/qsstv/faq.html

Step 2: Getting the software

The latest versions of QSSTV is always available at http://users.telenet.be/on4qz Download the latest tar file to a local directory (e.g. ~/Downloads)

Step 3: Compile and Install the software

Go to the directory you have chosen and extract the tar file. Note: replace the 9.4.2 with the appropriate version you have downloaded

>cd ~/Downloads
>tar -xvzf qsstv_9.4.2.tar.gz
>cd qsstv_9.4.2
>make -j2
>sudo make install

Step 4: Run QSSTV

You can now run the program by typing qsstv at the prompt of a terminal session, or make a short cut on your desktop.


Note: make -j2, 2 is the number of cores to be used for parallel compiling. If you have more cores, use a higher number. If you have problems compiling the software, please give as much information as possible but at least:

  • Linux Distribution (e.g. Ubuntu 18.04)
  • QT Version (e.g Qt 5.4.1)
  • Dump of the compile process showing the error

Step 5 (only for debug): Debug compile

If you want to be able to debug the program, the simplest way is to install QtCreator and from within QtCreator open a new project and point to the qsstv.pro file. Note: you will need to install doxygen and libqwt

sudo apt-get install doxygen libqwt-qt5-dev

You can also run qmake with the following atributes:

qmake CONFIG+=debug

and use an external debugger (such as gdb)