Install from source on Debian or Ubuntu

This is a quick guide for installing qolibri from source on GNU/Linux distributions based on Debian or Ubuntu, in case you can't or won't use the pre-built Debian release binaries.

If you want to hack on qolibri, you might want to follow this guide until you have the sources and then just open the CMakeLists.txt file as a project from an IDE such as Qt Creator or CLion.

This information is current as of Debian 10 "buster" and Ubuntu 18.04 LTS "bionic".

Install dependencies

The minimum dependencies can be installed with the following command:

$ sudo apt install -y --no-install-recommends \
    build-essential \
    cmake \
    libeb16-dev \
    qt5-default \
    qt5-qmake \
    qtbase5-dev \
    qtmultimedia5-dev \
    qttools5-dev \
    qttools5-dev-tools \
    qtwebengine5-dev \
    zlib1g-dev

Get the source code

Either:

• download and extract a source tarball from the Releases page, or
• clone the qolibri repository:

  $ git clone https://github.com/ludios/qolibri
  

Then change into the directory containing the qolibri sources, e.g.:

$ cd qolibri

Option A: Build and install .deb package

To create a .deb package in the parent directory, run:

$ dpkg-buildpackage

You can install it with:

$ sudo dpkg -i ../qolibri_<version>_<arch>.deb

Option B: Build and install without .deb packaging

If you don't need a .deb package, you can build using:

$ cmake -DCMAKE_BUILD_TYPE=Release .
$ make

Note: This will build in the source directory. To build in another directory, change to that instead and replace the . in the command above with a path to the qolibri source directory.

Note: This will generate Makefiles which install qolibri to the /usr/local prefix. You can set a different prefix by adding -DCMAKE_INSTALL_PREFIX=/my/install/prefix to the CMake call.

Once the build has finished, run:

$ sudo make install

to install qolibri (to /usr/local/bin, unless you have passed a different CMAKE_INSTALL_PREFIX to CMake). You can also just copy the qolibri binary anywhere. It contains all required resources.