Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Linux build Qt5
QLC+ Installation from sources on Linux (Debian, Ubuntu, Fedora, RedHat)
You need a number of packages installed before you can compile QLC+ from sources. Everything here happens in the terminal window, so launch one now. Usually it's an entry under Accessories in your desktop main menu.
Issue these commands to install the required packages for an Ubuntu system:
sudo apt-get update
sudo apt-get install g++ make git build-essential qt5-default qtbase5-dev qtscript5-dev qtmultimedia5-dev libqt5multimedia5-plugins qttools5-dev-tools fakeroot debhelper devscripts pkg-config
sudo apt-get install libasound2-dev libusb-dev libftdi-dev libudev-dev libmad0-dev libsndfile1-dev libfftw3-dev
With recent Ubuntu/Qt versions you might also need to install:
sudo apt-get install libglib2.0-dev libpulse-dev
If you intend on doing a lot of development, cleaning often and recompiling everything, you might want to install ccache, which speeds up consequent compilations (after the first caching run) IMMENSELY.
sudo apt-get install ccache
sudo ln -s /usr/bin/ccache /usr/local/bin/gcc
sudo ln -s /usr/bin/ccache /usr/local/bin/g++
sudo ln -s /usr/bin/ccache /usr/local/bin/cc
sudo ln -s /usr/bin/ccache /usr/local/bin/c++
Issue these commands to install the required packages for a Fedora/RedHat system:
yum install gcc-c++ qtbase5-common-devel qtmultimedia5-devel libftdi-devel libusb-devel alsa-lib-devel rpm-build git libudev-devel libsndfile-devel libmad-devel
yum install systemd-devel fftw-devel qt5-qtscript-devel qt5-qtmultimedia-devel qt5-qtbase-devel # Fedora 21
Notice that there's a space between su and - and that you need to give the root user password for su. When you're done with these commands, become a normal user again with:
If you wish to get the latest released QLC+ version:
If you wish to get the very latest bleeding edge (but only if your intention is to do development or are just curious):
git clone git://github.com/mcallegari/qlcplus.git
This will create a directory called qlcplus which will contain the latest sources from GIT repository. After you have made the initial clone and later wish to keep living on the bleeding egde, you can just update the sources (instead of making a new checkout each time):
Debug or release mode
If you are a developer and want to contribute to QLC+, the default settings will build a debug version of the program. Please note that a debug version is bigger than a release one and might have worse performances.
If what you need is a production build, then you need to edit the
variables.pri file and change the following lines, adding a
+= of the build you need and
-= of the one you don't need:
CONFIG += release # Enable this when making a release
CONFIG -= debug # Disable this when making a release
Plugins build note
QLC+ needs several external dependencies to be compiled with all the plugins support.
If you want to exclude some of them from the build process then just comment them out by placing the character
# at the beginning of the plugin line in the file
#unix:SUBDIRS += ola
Build OLA (Open Lighting Architecture)
This step is optional depending if you need OLA or not. See previous paragraph in case you want to disable the OLA plugin.
To build the sources, acquire the latest tarball from github
Extract the package and enter into the OLA folder.
Follow the Linux build instructions.
Then, when build time comes, type:
sudo make install
Now you have two choices: either go ahead with the compilation and manual installation or, spend a little more time with packages in order to create separate QLC+ packages that you can easily upgrade (and uninstall) later. If you wish to do everything manually, continue reading. If you wish to create packages for Ubuntu/Debian, skip to the Package Creation section on this page.
Note: On some distributions, Qt5 is not the default Qt package, so you need to locate the 'qmake' executable in your computer.
For example in Ubuntu 14.04 you can find it in
You can quickly check if the version is correct by typing:
In general, you can invoke qmake with its absolute path. For example:
In this way you can build QLC+ with any Qt version, located where you prefer in your hard disk. If you wish to build QLC+ with the latest Qt version, you can get it here: https://www.qt.io/download-open-source/
Note: Out-of-tree builds are not tested and most probably do not work.
Issue the following commands to start building QLC+:
qmake (see note above)
To speed up the build process, if your computer has a multicore CPU you can use the -j option followed by the number of cores of your CPU, like this:
You should see your terminal filling with compiler messages for quite a while. Everything should go smoothly until the end. If it doesn't happen and you see misterious building errors try either to clone the repository again or completely clean your source tree and start over again:
OK. When the compiler is done, issue this command to install QLC+ to your system:
sudo make install
or, for non-sudo systems like Debian, Fedora etc:
su -c "make install"
Now you're done. Type
to start using QLC+. If you wish to edit/create fixture definitions, type:
(At least) on Debian-based systems, the installation script creates desktop menu entries that are usually available in your desktop main menu, under the Other category.
Debian/Ubuntu Package Creation
Go to the main QLC+ directory and issue the following command:
The package is now being built. If the process fails at an early stage, you are probalby missing some dependency package. See above what packages you need to install. When the package script is done, the newly-created packages appear to the folder, where you have the qlc folder, i.e. you need to go up once:
To install the packages, just type:
su -c "dpkg -i <package name>.deb"
Fedora/RedHat package creation
Go to the newly-created qlc sub-directory and issue the following command:
The script will create an RPM build directory structure under your home directory (~/rpmbuild) and build the packages there. When the packager is done, go and see the newly-created packages:
To install the packages, just type:
su -c "rpm -Uvh <package name>.rpm"
To install all packages, you can type:
su -c "rpm -Uvh qlcplus*.rpm"
You can find more information from the InstallationRedhat? pages (after they have been written, that is).