wfview/INSTALL_PREBUILT_BINARY.md

3.4 KiB

How to install wfview without building yourself on selected linux versions

We understand that downloading sources with git, selecting branches and building yourself may a bit daunting. In the future we may at some point start distributing packages and/or images like appimage, flatpack. snap.

Instructions how to use this w/o building yourself. We are using a precompiled version that has been tested on a few different versions of linux in alphabetical order. Note that all are click-click-next-next-finish installs.

not supported:

centos7 -- no qt support debian 10 -- outdated devuan 3.1.1.1 -- outdated redhat7 -- no qt support

Debian 11  (Debian 10 is outdated)
Fedora 33
Fedora 34
mint 20.1 (and up?)
openSUSE 15.2
openSUSE 15.3 (see notes at the end)
openSUSE Tumbleweed(s)
SLES 15.x
Ubuntu 20.04.2 
mint 20.2     (see notes at the end)

for all, the following is applicable:

download the tar.gz file here: https://wfview.org/download/test-linux-build/ 

the file below will unpack in ./dist

tar zxvf wfview-linux.tar.gz        (change the filename accordingly)          
cd dist
sudo ./install.sh

this will install the binary and a few other files to your system.

Now for the system specifics; pick your version:

Debian 11:

sudo apt install libqcustomplot2.0 libqt5multimedia5 libqt5serialport5
sudo ln -s /usr/lib/x86_64-linux-gnu/libqcustomplot.so.2.0.1 /usr/lib/x86_64-linux-gnu/libqcustomplot.so.2
wfview

Fedora 33/34:

sudo dnf install qcustomplot-qt5 qt5-qtmultimedia qt5-qtserialport
sudo ln  -s  /usr/lib64/libqcustomplot-qt5.so.2 /usr/lib64/libqcustomplot.so.2
wfview

Mint 20.1

sudo apt install libqcustomplot2.0 libqt5multimedia5 libqt5serialport5
sudo ln  -s  /usr/lib64/libqcustomplot-qt5.so.2 /usr/lib64/libqcustomplot.so.2
wfview

note: if the above symlink fails, use the following line to fix the library link:

sudo ln -s /lib/x86_64-linux-gnu/libqcustomplot.so.2.0.1 /lib/x86_64-linux-gnu/libqcustomplot.so.2

Mint 20.2


SEE THE NOTES AT THE END. You need wfview153 binary here

sudo apt install libqcustomplot2.0 libqt5multimedia5 libqt5serialport5
sudo ln  -s  /usr/lib64/libqcustomplot-qt5.so.2 /usr/lib64/libqcustomplot.so.2
wfview

note: if the above symlink fails, use the following line to fix the library link:

sudo ln -s /lib/x86_64-linux-gnu/libqcustomplot.so.2.0.1 /lib/x86_64-linux-gnu/libqcustomplot.so.2

openSUSE/Tumbleweed/SLES based on 15.2:

sudo zypper in libqcustomplot2 libQt5SerialPort5
wfview

openSUSE/Tumbleweed/SLES based on 15.3:


SEE THE NOTES AT THE END. You need wfview153 here

sudo zypper in libqcustomplot2 libQt5SerialPort5
wfview

UBUNTU:

sudo apt install libqcustomplot2.0 libqt5multimedia5 libqt5serialport5
sudo ln -s /usr/lib/x86_64-linux-gnu/libqcustomplot.so.2.0.1 /usr/lib/x86_64-linux-gnu/libqcustomplot.so.2
wfview


note: if the above symlink fails, use the following line to fix the library link:

sudo ln -s /lib/x86_64-linux-gnu/libqcustomplot.so.2.0.1 /lib/x86_64-linux-gnu/libqcustomplot.so.2

notes:


Some newer versions of mint. ubuntu, openSUSE have different kernels and such which cause wfview to segfault.

For these cases we created two binaries: one for current systems ("wfview")  and one for the new systems ("wfview153")

So if you encounter a SEGFAULT at start: 

go in to the dist directory, rename wfview to wfvie152; rename wfview153 to wfview and re-execute the install.sh
script