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.12.1 | XOR libnpupnp | pupnp | ||
| libnpupnp | >=4.0.11 | XOR libupnp | npupnp | ||
| 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
Using Conan¶
The simplest way to fetch dependencies and build Gerbera is to use Conan. Please read more here.
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 Ubuntu 18.04¶
To build gerbera on Ubuntu 18.04 you have to install a newer version of the gcc++ compiler and clang++:
sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
sudo apt update
sudo apt upgrade
sudo apt install -y build-essential xz-utils curl gcc-8 g++-8 clang clang-9 libssl-dev pkg-config
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 30
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-8 60
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-7 30
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-8 60
sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-9 60
sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-6.0 30
sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-9 60
sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-6.0 30
sudo update-alternatives --config gcc
sudo update-alternatives --config g++
sudo update-alternatives --config clang
sudo update-alternatives --config clang++
sudo update-alternatives --set cc /usr/bin/clang
sudo update-alternatives --set c++ /usr/bin/clang++
git clone https://github.com/Kitware/CMake
cd CMake
./configure
make
sudo make install
cd ..
Install all libraries gerbera needs. Because they are to old libupnp, libfmt must be build and installed from the source:
sudo apt install -y uuid-dev libsqlite3-dev libmysqlclient-dev libmagic-dev \
libexif-dev libcurl4-openssl-dev libspdlog-dev libpugixml-dev libavutil-dev \
libavcodec-dev libavformat-dev libavdevice-dev libavfilter-dev libavresample-dev \
libswscale-dev libswresample-dev libpostproc-dev duktape-dev libmatroska-dev \
libsystemd-dev libtag1-dev ffmpeg
Build and install libupnp with the --enable-ipv6 and --enable-reuseaddr option and libfmt from sourcec
wget "https://downloads.sourceforge.net/project/pupnp/pupnp/libupnp-1.12.1/libupnp-1.12.1.tar.bz2?r=https%3A%2F%2Fsourceforge.net%2Fprojects%2Fpupnp%2Ffiles%2Flatest%2Fdownload&ts=1588248015" -O libupnp-1.12.1.tar.bz2
tar -xf libupnp-1.12.1.tar.bz2
cd libupnp-1.12.1
./configure --enable-ipv6 --enable-reuseaddr
make
sudo make install
cd ..
git clone https://github.com/fmtlib/fmt
cd fmt
cmake .
make
sudo make install
cd ../..
It is strongly recommended to to rebuild spdlog without bundled fmt:
git clone https://github.com/gabime/spdlog
cd spdlog
cmake -D "SPDLOG_FMT_EXTERNAL:BOOL=true" .
make
sudo make install
Now it’s time to get the source of gerbera and compile it.
git clone https://github.com/gerbera/gerbera.git
mkdir build
cd build
cmake -DWITH_MAGIC=1 -DWITH_MYSQL=1 -DWITH_CURL=1 -DWITH_JS=1 -DWITH_TAGLIB=1 -DWITH_AVCODEC=1 -DWITH_EXIF=1 -DWITH_LASTFM=0 -DWITH_SYSTEMD=1 ../gerbera
make
sudo make install
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.