OpenCine.Build Instructions

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 Clone repository

• Create folder to contain source and builds, should reside in home

mkdir ~/Source

• 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

3 Install required packages

Run the command `env_setup.sh` to install the required packages automatically. Incase this does not work, resort to following command line instructions to get the required packages.

Ubuntu

Command line: sudo apt-get install git cmake build-essential freeglut3-dev libavformat-dev libswscale-dev libavfilter-dev libavdevice-dev libavresample-dev

ArchLinux

Command line: sudo pacman -S git cmake base-devel freeglut ffmpeg

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
  

  Qt install path
• Click Next, select x64 libraries and QtCreator, deactivate other options, as they are not required
  

  Required options
• Start installation
• Afterwards you can proceed to the build from command line or in QtCreator
  • Command line: Deactivate Launch QtCreator, click Finish -> #Build from command line
  • QtCreator: Just click Finish -> #Build in QtCreator

4 Build from command line

• 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

• The build could appear to freeze at some point, but it just downloads external projects, CMake 3.5 does not display download progress, this feature should be available in 3.8
• If the build succeeded, then executable files can be found in OpenCine_build/bin

5 Build in QtCreator

• QtCreator should start up, if you have deactivated the check box in the setup, then launch manually
• Go to File → Open File or Project...
• Load CMakeLists.txt from the main folder
• First time QtCreator will ask for configuration
  • It's sufficient for basic usage to select just Debug and Release
  • Adjust the path for build, you can use the same approach as command line instructions and select OpenCine_build in Source folder, e.g. /home/<user name>/Source/Opencine_build
• CMake configuration is ran automatically
• Select required configuration in the bottom-left area
• Click on the Hammer button and let it build
• If the build succeeded, then just start the application by using F5 (Debug) or Ctrl + R (Run)