<picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://github.com/gerbera/gerbera/blob/master/artwork/logo-horiz-white.png?raw=true">
 <source media="(prefers-color-scheme: light)" srcset="https://github.com/gerbera/gerbera/blob/master/artwork/logo-horiz.png?raw=true">
 <img alt="GERBERA" src="https://github.com/gerbera/gerbera/blob/master/artwork/logo-horiz.png?raw=true" />
</picture>

# Gerbera - UPnP Media Server

[![Current Release](https://img.shields.io/github/release/gerbera/gerbera.svg?style=for-the-badge)](https://github.com/gerbera/gerbera/releases/latest) [![Build Status](https://img.shields.io/github/actions/workflow/status/gerbera/gerbera/ci.yml?style=for-the-badge&branch=master)](https://github.com/gerbera/gerbera/actions?query=workflow%3A%22CI+validation%22+branch%3Amaster) [![Docker Version](https://img.shields.io/docker/v/gerbera/gerbera?color=teal&label=docker&logoColor=white&sort=semver&style=for-the-badge)](https://hub.docker.com/r/gerbera/gerbera/tags?name=3.) [![Documentation Status](https://img.shields.io/readthedocs/gerbera?style=for-the-badge)](http://docs.gerbera.io/en/stable/?badge=stable) [![IRC](https://img.shields.io/badge/IRC-on%20libera.chat-orange.svg?style=for-the-badge)](https://web.libera.chat/?channels=#gerbera)

[![Packaging Status](https://repology.org/badge/tiny-repos/gerbera.svg?header=PACKAGES&style=for-the-badge)](https://repology.org/metapackage/gerbera/versions)

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](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](https://docs.gerbera.io/en/stable/install.html) for instructions on
how to install Gerbera.

## Building
Visit our docs for instructions to [Compile Gerbera](https://docs.gerbera.io/en/stable/compile.html) or [Compile latest Gerbera](https://docs.gerbera.io/en/latest/compile.html).

### 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.20      | 1.14.25              | XOR libnpupnp | UPnP protocol support            |          |
| [libnpupnp]         | 4.2.1        | 5.1.2        | 6.2.1                | 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.6                | Required      | JSON data support                |          |
| 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.1.1                | Optional      | Audio tag support                | Enabled  |
| libmagic            |              |              |                      | Optional      | File type detection              | Enabled  |
| [wavpack]           | 5.1.0        | 5.4.0        | 5.8.1                | 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.7              | 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-g8992d6         | 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.0         | 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

[cmake]: https://cmake.org/
[Docker Hub]: https://hub.docker.com/r/gerbera/gerbera
[doxygen]: https://github.com/doxygen/doxygen
[duktape]: https://duktape.org
[ffmpegthumbnailer]: https://github.com/dirkvdb/ffmpegthumbnailer
[fmtlib]: https://github.com/fmtlib/fmt
[googletest]: https://github.com/google/googletest
[icu4c]: https://github.com/unicode-org/icu
[jsoncpp]: https://github.com/open-source-parsers/jsoncpp
[lastfmlib]: https://github.com/dirkvdb/lastfmlib
[libebml]: https://github.com/Matroska-Org/libebml
[libexif]: https://github.com/libexif/libexif
[libexiv2]: https://github.com/Exiv2/exiv2
[libmatroska]: https://github.com/Matroska-Org/libmatroska
[libnpupnp]: https://www.lesbonscomptes.com/upmpdcli/npupnp-doc/libnpupnp.html
[libpq]: https://www.postgresql.org/download
[libpqxx]: https://github.com/jtv/libpqxx
[libsystemd]: https://github.com/systemd/systemd
[libupnp]: https://github.com/pupnp/pupnp
[libzip]: https://github.com/nih-at/libzip
[libzippp]: https://github.com/ctabin/libzippp
[pugixml]: https://github.com/zeux/pugixml
[spdlog]: https://github.com/gabime/spdlog
[taglib]: https://taglib.org/
[wavpack]: https://www.wavpack.com/
