QLC Plus 5 build HOWTO

QLC+ 5 build instructions

Building QLC+ 5 is very similar to building QLC+ 4.
However, the minimum Qt version required is 5.14.2.
It is recommended to use the official Qt versions via online installer

Notes about Qt:

• Qt 6.x build is not yet supported!
• Qt 5.15.x on Linux misses a Qt3D plugin, so meshes will not be loaded. Use Qt 5.14.2 instead.

The environment preparation is the same explained for Linux, Windows and macOS.

On Linux, add the following development packages:
sudo apt install qt3d5-dev qt3d-defaultgeometryloader-plugin qt3d-assimpsceneimport-plugin qml-module-qt3d qml-module-qtquick-scene3d qml-module-qtmultimedia

When it comes the time to invoke cmake, add the -Dqmlui=ON option. Examples:

Windows:

cmake -G "Unix Makefiles" -Dqmlui=ON ..
make
make install (binaries will go to C:\qlcplus)

macOS:

export QTDIR=/Users/myuser/Qt5.15.2/5.15.2/clang_64
$QTDIR/bin/qmake CONFIG+=qmlui
make
make install (binaries will be bundled into /Users/myuser/QLC+.app)

or

export QTDIR=/Users/myuser/Qt5.15.2/5.15.2/clang_64
./create-dmg.sh CONFIG+=qmlui

Linux:

cmake -DCMAKE_PREFIX_PATH="/home/myuser/Qt/5.15.2/gcc_64/lib/cmake" -Dqmlui=ON ..
make
make install (binaries will be installed in your system. Warning: this will overwrite QLC+ 4)

or

export QTDIR=/home/myuser/Qt5.14.2/5.14.2/gcc_64
./create-appimage-cmake.sh (a file called Q_Light_Controller_Plus-x86_64.AppImage will be created in /home/myuser)

P.S. Obviously replace myuser with the name of your *nix user !