OpenCine.Build Instructions

From apertus wiki
Jump to: navigation, search

1 Prerequisites

Installation will be described in the OS related sections.

  • Ubuntu / LinuxMint
  • Qt 5.7 or 5.8
  • Git
  • CMake
  • GCC / G++
  • OpenGL headers (e.g. FreeGLUT3 dev package)
  • FFMPEG dev libraries

2 Ubuntu

Install required packages
Command line: sudo apt-get install git cmake build-essential freeglut3-dev libavformat-dev libswscale-dev libavfilter-dev libavdevice-dev libavresample-dev
Qt 5.8 (same aplpies to 5.7)
  • It's assumed that user will download the file to /home/<user>/Downloads
  • Download Qt installer from [[1]]
Alternative terminal command: wget http://download.qt.io/official_releases/qt/5.8/5.8.0/qt-opensource-linux-x64-5.8.0.run
  • Set type to executable: chmod +x qt-opensource-linux-x64-5.8.0.run
  • Run installer: ./qt-opensource-linux-x64-5.8.0.run
  • Click Next until path selection is shown, then select following path: /home/<user>/Qt (TODO: Add screenshot)
  • Click Next, select x64 libraries and QtCreator, deactivate other options, as they are not required(TODO: Add screenshot)
  • Start installation
  • Afterwards you can proceed to the build from command line or in QtCreator


3 Build from command line

  • Create folder to contain source and builds, should reside in home
mkdir ~/OpenCine
  • Clone repository, you can select between master and dev branches
    • master is updated less often, but has usually stable code in it
    • dev is updated often, but could contain broken code, in this case WIP text is added to commit description
git clone --branch <branch name> --single-branch https://github.com/apertus-open-source-cinema/opencine.git $HOME/Source/OpenCine
  • Change to Source folder
  • Create a folder for the build, change to it
mkdir OpenCine_build
cd OpenCine_build
  • Start CMake configuration, Qt path has to be supplied
cmake -DCMAKE_PREFIX_PATH=$HOME/Qt/5.8/gcc_64/lib/cmake/ ../OpenCine
  • Start the build, here we use 4 threads to accelerate it
make -j4
  • If the build succeeded, then executable files can be found in OpenCine_build/bin

4 Build in QtCreator

TODO