Instalation from sources

Installation from sources

One simple solution is to install the program from the package for your distribution. Access the list of packages at our site.

Prerequisites

Boomaga uses CMake as its build tool, and requires following libraries:

• Qt5
• cups
• snappy
• poppler-cpp

The names of packages depend on your distributions. Here are instructions for some of the popular distributions:

Ubuntu / Debian

sudo apt-get install \
  build-essential \
  cmake \
  pkg-config \
  qtbase5-dev \
  qttools5-dev-tools \
  qttools5-dev \
  libcups2-dev \
  libpoppler-cpp-dev \
  libsnappy-dev

Ubuntu (Xenial and later)

sudo apt-get install \
  build-essential \
  cmake \
  qtbase5-dev \
  qttools5-dev-tools \
  libcups2-dev \
  libpoppler-cpp-dev \
  libsnappy-dev

Fedora

sudo dnf install \
  git \
  cmake \
  qt5-qtbase-devel \
  qt5-qttools-devel \
  cups-devel \
  poppler-cpp-devel \
  snappy-devel \
  selinux-policy-devel

ArchLinux and Manjaro

sudo pacman -S \
  devtools \
  cmake \
  qt5-tools \
  cups \
  snappy \
  poppler

Getting sources

You can download sources of the latest stable version here. The home codes of the version being developed are always accessible at our page in github (https://github.com/Boomaga/boomaga). You can get them as follows:

git clone git://github.com/Boomaga/boomaga.git

Building and installing

We use so-called out-of-source builds. They support having different builds with different configurations simultaneously as well as easily remove the build directory if something goes wrong. So, create a directory in ~/boomaga, say build, and cd into it. Type

mkdir ~/boomaga/build
cd ~/boomaga/build
cmake ..

You may use alternative paths to some of the directories. Use the following options in cmake.

Option	Default for Linux	Description
-DCUPS_BACKEND_DIR	/usr/lib/cups/backend	Path to CUPS backends.
-DCUPS_PPD_DIR	/usr/share/ppd/boomaga	Path to CUPS PPD files.
-DDBUS_MACINE_ID_DIR	/var/lib/dbus	Path where D-Bus machine-id file is placed.
-DDBUS_SERVICE_DIR	/usr/local/share/dbus-1/services	Path to D-Bus service description files.

Example:

cmake -DCUPS_BACKEND_DIR=/usr/local/libexec/cups/backend -DDBUS_MACINE_ID_DIR=/var/db/dbus ..

For building and installing please perform the following commands:

make && sudo make install

Installing the printer

Once the program has been installed, it’s time to add the virtual printer. Please note that this has to be done only once. You don’t have to install the printer over again when updating the program.

The best solution is to use the scripts/installPrinter.sh from sources tree– just run it.

sudo ./installPrinter.sh

If you wish to install the printer on your own, select "Local Printers: Boomaga (Virtual boomaga printer)" in the "create printer" dialogue and indicate the type, "Generic Virtual boomaga printer" or, if you can’t access the previous, select the "build/cups/boomaga.ppd" PPD file.

Troubleshooting

If you have some problems with Boomaga, see the Debugging page.