Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gerbera/gerbera

UPnP Media Server for 2024: Stream your digital media through your home network and consume it on all kinds of UPnP supporting devices 📱💻📺
https://github.com/gerbera/gerbera

c-plus-plus cmake dlna dlna-server duktape flac gerbera inotify javascript libupnp m3u8 mediaserver mp3 nfo ogg stream transcoding upnp upnp-av web-ui

Last synced: about 1 month ago
JSON representation

UPnP Media Server for 2024: Stream your digital media through your home network and consume it on all kinds of UPnP supporting devices 📱💻📺

Host: GitHub
URL: https://github.com/gerbera/gerbera
Owner: gerbera
License: other
Created: 2014-08-09T13:17:53.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2024-04-13T07:59:03.000Z (5 months ago)
Last Synced: 2024-04-15T04:02:07.626Z (5 months ago)
Topics: c-plus-plus, cmake, dlna, dlna-server, duktape, flac, gerbera, inotify, javascript, libupnp, m3u8, mediaserver, mp3, nfo, ogg, stream, transcoding, upnp, upnp-av, web-ui
Language: C++
Homepage: https://gerbera.io
Size: 42.8 MB
Stars: 1,136
Watchers: 38
Forks: 210
Open Issues: 86
Metadata Files:
- Readme: README.Docker.md
- Changelog: ChangeLog.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Authors: AUTHORS

Awesome Lists containing this project

awesome-starred - gerbera/gerbera - UPnP Media Server for 2023: Stream your digital media through your home network and consume it on all kinds of UPnP supporting devices 📱💻📺 (javascript)
awesome-homelab - Gerbera

README

# 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=2.) [![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%20freenode-orange.svg?style=for-the-badge)](https://webchat.freenode.net/?channels=#gerbera)

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.

## Documentation
For general help on using Gerbera, head over to our documentation online at [docs.gerbera.io](https://docs.gerbera.io).

# Image Architectures
- amd64
- armv7
- arm64

# Network Setup

## Ports
Port `49494/tcp` (HTTP, also set as gerbera port via command line) and `1900/udp` (SSDP Multicast) are exposed by default.

## Multicast
UPnP relies on having clients and servers able to communicate via IP Multicast.
The default docker bridge network setup does not support multicast. The easiest way to achieve this is to use
"host networking".
Connecting Gerbera to your network via the "macvlan" driver should work, but remember you will not be
able to access the container from the docker host with this method by default.

# Transcoding Tools
Transcoding tools are made available in a separate image with the `-transcoding` suffix.
e.g. `gerbera/gerbera:2.2.0-transcoding`. Includes tools such as ffmpeg and vlc.

# Examples

## Serve some files via a volume
```console
$ docker run \
--name some-gerbera \
--network=host \
-v /some/files:/mnt/content:ro \
gerbera/gerbera:vX.X.X
```

or for those that prefer docker-compose:

```console
---
version: "2.2"
services:
gerbera:
image: gerbera/gerbera
container_name: gerbera
network_mode: host
volumes:
- gerbera-config:/var/run/gerbera
- /some/files:/mnt/content:ro

volumes:
gerbera-config:
external: false
```

The directory `/mnt/content` is automatically scanned for content by default.
Host networking enables us to bypass issues with broadcast across docker bridges.

You may place custom JavaScript files in the directory `/mnt/customization/js`.
Every time Gerbera creates `/var/run/gerbera/config.xml`, the shell script
`/mnt/customization/shell/gerbera_config.sh` (if existing) will be executed.

## Provide your own config file
```console
$ docker run \
--name another-gerbera \
--network=host \
-v /some/files:/mnt/content:ro \
-v /some/path/config.xml:/var/run/gerbera/config.xml \
gerbera/gerbera:vX.X.X
```

## Overwrite default ports

In cases (e.g. running multiple gerbera containers with different versions) you can override the exported ports

```console
$ docker run \
--name another-gerbera \
--network=host \
--expose : \
-v /some/files:/mnt/content:ro \
gerbera/gerbera:vX.X.X gerbera --port --config /var/run/gerbera/config.xml
```