Compile Gerbera

Gerbera uses the excellent CMake build system.

Dependencies

Note

Remember to install associated development packages, because development headers are needed for compilation!

In order to compile Gerbera you will have to install the following packages:

Library

Version

Required?

Note

Compile-time option

Default

libupnp

>=1.8.6

Required

pupnp

libuuid

Depends on OS

On BSD native libuuid is used others require e2fsprogs-libuuid

pugixml

Required

fmtlib

Required

libiconv

Required

sqlite3

Required

Database storage

duktape

Optional

Scripting Support

WITH_JS

Enabled

mysql

Optional

Alternate database storage

WITH_MYSQL

Disabled

curl

Optional

Enables web services

WITH_CURL

Enabled

taglib

1.11.1

Optional

Audio tag support

WITH_TAGLIB

Enabled

libmagic

Optional

File type detection

WITH_MAGIC

Enabled

ffmpeg/libav

Optional

File metadata

WITH_AVCODEC

Disabled

libexif

Optional

JPEG Exif metadata

WITH_EXIF

Enabled

libexiv2

Optional

Exif, IPTC, XMP metadata

WITH_EXIV2

Disabled

lastfmlib

0.4.0

Optional

Enables scrobbling

WITH_LASTFM

Disabled

ffmpegthumbnailer

Optional

Generate video thumbnails

WITH_FFMPEGTHUMBNAILER

Disabled

inotify

Optional

Efficient file monitoring

WITH_INOTIFY

Enabled

Quick Start Build

git clone https://github.com/gerbera/gerbera.git
mkdir build
cd build
cmake ../gerbera -DWITH_MAGIC=1 -DWITH_MYSQL=1 -DWITH_CURL=1 -DWITH_JS=1 \
-DWITH_TAGLIB=1 -DWITH_AVCODEC=1 -DWITH_FFMPEGTHUMBNAILER=1 -DWITH_EXIF=1 -DWITH_LASTFM=1
make -j4
sudo make install

Alternatively, the options can be set using a GUI (make sure to press “c” to configure after toggling settings in the GUI):

git clone https://github.com/gerbera/gerbera.git
mkdir build
cd build
cmake ../gerbera
make edit_cache
# Enable some of the WITH... options
make -j4
sudo make install

Build On Ubuntu 16.04

apt-get install uuid-dev libsqlite3-dev libmysqlclient-dev \
libmagic-dev libexif-dev libcurl4-openssl-dev libspdlog-dev libpugixml-dev
# If building with LibAV/FFmpeg (-DWITH_AVCODEC=1)
apt-get install libavutil-dev libavcodec-dev libavformat-dev libavdevice-dev \
libavfilter-dev libavresample-dev libswscale-dev libswresample-dev libpostproc-dev

The following packages are too old in 16.04 and must be installed from source: taglib (1.11.x), and libupnp (1.8.x).

libupnp must be configured/built with --enable-ipv6. See scripts/install-pupnp18.sh for details.

Build On FreeBSD

The following has been tested on FreeBSD 11.0 using a clean jail environment.

1. Install the required prerequisites as root using either ports or packages. This can be done via Package manager or ports. (pkg manager is used here.) Include mysql if you wish to use that instead of SQLite3.

pkg install wget git autoconf automake libtool taglib cmake gcc libav ffmpeg \
libexif pkgconf liblastfm gmake

2. Clone repository, build depdences in current in ports and then build gerbera.

git clone https://github.com/gerbera/gerbera.git
mkdir build
cd build
sh ../gerbera/scripts/install-pupnp18.sh
sh ../gerbera/scripts/install-duktape.sh
cmake ../gerbera -DWITH_MAGIC=1 -DWITH_MYSQL=0 -DWITH_CURL=1 -DWITH_JS=1 -DWITH_TAGLIB=1 -DWITH_AVCODEC=1 \
-DWITH_EXIF=1 -DWITH_LASTFM=0 -DWITH_SYSTEMD=0
make -j4
sudo make install

Build On macOS

The following has been tested on macOS High Sierra 10.13.4

The Gerbera Team maintains a Homebrew Tap to build and install Gerbera Media Server. Take a look at the Homebrew formula to see an example of how to compile Gerbera on macOS.

homebrew-gerbera/gerbera.rb