The latest version of WSJT-X, 1.7.0, was released on 19 December, 2016. I found that the available Debian formatted package would not install as it is built for Ubuntu 16.04.1 (and variants) which has a newer version of Qt5 on it than Devuan Jessie (as Devuan Jessie is mostly a downstream distribution of Debian 8, Jessie, these notes should apply to it as well).
The package that kept WSJT-X from installing was
libqt5core5a which depends
on Qt5 5.5 while all the other packages depend on Qt5 5.2. Strange.
Regardless, download the source tarball and off to compiling we go!
In any source package a file named
INSTALL is present to provide information
on the needed build dependencies. I found the list to be slightly incorrect.
Minimum package versions are listed in this file and the versions in Jessie
are newer so compilation will succeed once all of the proper -dev packages are
installed. On Devuan there is usually a “meta” package that has the latest
version of its package as a dependency so that older versions may be installed
manually, if needed.
The minimal list of packages that need to be installed are:
build-essential gcc g++ gfortran cmake git subversion asciidoc asciidoctor xmlto libfftw3-dev libqt5serialport5-dev qtmultimedia5-dev libusb-dev libudev-dev libqt5multimedia5-plugins
When your package manager is configured to install recommended packages, some
of the packages will install several more packages than are actually needed.
In my case I have that option disabled so I had to install the
separately to allow the WSJT-X documentation to be built.
There is no one Qt5 development package, so I installed the two Qt development packages shown above which themselves required run time libraries and other development packages needed to build WSJT-X.
On one computer I needed to install the libudev-dev package to resolve a linker error while another computer didn’t require it. Strange.
Finally, I needed to install the
libqt5multimedia5-plugins package so that
the sound cards could be found by WSJT-X at run time.
That completes the list of packages needed for compilation. The rest of the
INSTALL should be followed to configure, build, and install
WSJT-X. The install step will likely require superuser (
when the default install path is used (
/usr/local), though the instructions
don’t mention it.
As I use Pulse Audio as an audio routing daemon, it is necessary to modify its
configuration slightly as WSJT-X requires 16 bit audio at a 48 kHz sample
rate. The easiest way to handle this is to copy the file
$HOME/.pulse/daemon.conf and modify the version
in your home directory.
Find the line
; default-sample-rate = 44100 toward the end of the file,
delete the leading semicolon and space and then change the value to 48000. It
should now look like this:
default-sample-rate = 48000
Save the file.
As Pulse Audio is started by the desktop environment on Devuan, it’s probably
easiest to log out of the desktop environment. Doing so doesn’t necessarily
shut down the Pulse Audio daemon! What I did was log in to one of the virtual
Ctl-Alt-F1), use the command
ps x -u <username> to see if the
pulseaudio daemon is running and if so, run the
killall pulseaudio command
to terminate it. Then I logged back into the desktop environment in the usual
Alt-F7 to jump to the GUI login screen.
Once the desktop environment was up and running, I used the PulseAudio Manager program to check the properties of the sound device I use for the radio interface to be sure it was showing a sample rate of 48 kHz. Then I was able to start WSJT-X and it found the sound device and off we went.
While these notes are mostly for my own future reference, perhaps they will assist someone else.