Gerbera - UPnP Media Server

Gerbera is a UPnP media server which allows you to stream your digital media through your home network and consume it on a variety of UPnP compatible devices.

Pull requests are very welcome and reporting issues is encouraged.

Documentation

View our documentation online at https://docs.gerbera.io.

Features

Browse and playback your media via your network on all kinds of devices.
Web UI with a tree view of the database and the file system, allowing to add/remove/edit/browse your media
Metadata extraction from MP3, OGG, AAC, M4A, FLAC, wavpack, JPG (and many more!) files.
Media thumbnail support
Highly flexible media format transcoding via plugins / scripts
Automatic directory rescans (timed, inotify)
User defined server layout based on extracted metadata
Supports last.fm scrobbing
On the fly video thumbnail generation
Support for external URLs (create links to internet content and serve them via UPnP to your renderer)
Runs on Linux, BSD, Mac OS X, and more!
Runs on x86, ARM, MIPS, and more!

Installing

Head over to the docs page on Installing Gerbera for instructions on how to install Gerbera.

Building

Visit our docs for instructions to Compile Gerbera or Compile latest Gerbera.

Quick start build instructions:

git clone https://github.com/gerbera/gerbera.git
mkdir build
cd build
cmake ../gerbera --preset=release-pupnp
make -j4
sudo make install

Dependencies

| Library | Min Version | Recommended | Latest tested | Required? | Note | Default | |---------------------|--------------|--------------|----------------------|---------------|----------------------------------|----------| | libupnp | 1.14.6 | 1.14.30 | 1.18.3 | XOR libnpupnp | UPnP protocol support | | | libnpupnp | 4.2.1 | 5.1.2 | 6.2.3 | XOR libupnp | Alternate UPnP protocol support | Disabled | | libuuid | | | | Depends on OS | Not required on *BSD | | | pugixml | | 1.10 | 1.15 | Required | XML file and data support | | | jsoncpp | 1.7.4 | 1.9.6 | 1.9.7 | Required | JSON data support | | | cxxopts | 3.2.0 | 3.2.1 | 3.3.1 | Required | Command line parsing | Bundled | | libiconv | | | | Required | Charset conversion | | | sqlite3 | 3.7.0 | 3.35.5 | 3.50.2 | Required | Database storage | | | zlib | | | | Required | Data compression | | | fmtlib | 7.1.3 | 11.2.0 | 12.1.0 | Required | Fast string formatting | | | spdlog | 1.8.1 | 1.15.3 | 1.17.0 | Required | Runtime logging | | | icu4c | 65.1 | 65.1 | 65.1 | Required | Transliteration | Enabled | | duktape | 2.1.0 | 2.6.0 | 2.7.0 | Optional | Scripting Support | Enabled | | mysql | | | | Optional | Alternate database MySQL/MariaDB | Disabled | | libpqxx | 7.10.1 | 7.10.3 | 7.10.3 | Optional | Alternate database PostgreSQL | Disabled | | libpq | 12.22 | | 17.0.6 | Optional | required by libpqxx | Disabled | | curl | | | | Optional | Enables web services | Enabled | | taglib | 1.12 | 1.12 | 2.2.1 | Optional | Audio tag support | Enabled | | libmagic | | | | Optional | File type detection | Enabled | | wavpack | 5.1.0 | 5.4.0 | 5.9.0 | Optional | WavPack metadata support | Disabled | | libmatroska | 1.4.8 | 1.6.3 | 1.7.1 | Optional | MKV metadata | Enabled | | libebml | 1.3.5 | 1.4.2 | 1.4.5 | Optional | required by libmatroska | Enabled | | ffmpeg/libav | | | 7.1.2 | Optional | File metadata | Disabled | | libexif | v0.6.21 | v0.6.24 | v0.6.25 | Optional | JPEG Exif metadata | Enabled | | libexiv2 | v0.26 | v0.27.7 | v0.28.8 | Optional | Exif, IPTC, XMP metadata | Disabled | | lastfmlib | 0.4.0 | 0.4.0 | 0.4.0 | Optional | Enables scrobbling | Disabled | | ffmpegthumbnailer | 2.1.1 | 2.2.3 | 2.3.0 | Optional | Generate video/image thumbnails | Disabled | | libsystemd | 237 | 254 | 257 | Optional | Interact with systemd | Disabled | | inotify | | | | Optional | Efficient file monitoring | Enabled | | libzippp | v7.1-g8992d6 | v7.1-g8992d6 | v7.1-gd4a60d | Optional | ZIP Package download | Enabled | | libzip | 1.10.1 | 1.11.4 | 1.11.4 | Optional | Required for libzippp | Enabled |

Development Dependencies

| Library | Min Version | Recommended | Latest tested | Required? | Note | Default | |---------------------|-------------|-------------|---------------|---------------|--------------------------------|----------| | googletest | 1.10.0 | 1.10.0 | 1.17.0 | Optional | Running tests | Disabled | | doxygen | | 1.8.14 | 1.8.14 | Optional | Building source documentation | Disabled | | cmake | 3.25.0 | 3.31.38 | 4.2.3 | Required | Build processing | Enabled |

License

GPLv2

Copyright (C) 2005
   Gena Batyan <bgeradz at mediatomb dot cc>
   Sergey Bostandzhyan <jin at mediatomb dot cc>

Copyright (C) 2006-2008
   Gena Batyan <bgeradz at mediatomb dot cc>
   Sergey Bostandzhyan <jin at mediatomb dot cc>
   Leonhard Wimmer <leo at mediatomb dot cc>

Copyright (C) 2016-2025
    Gerbera Contributors

Gerbera

Install / Use

README