Gerbera

Gerbera is an open source UPnP media server that streams digital media through a home network to UPnP compatible devices. Gerbera is based on MediaTomb 0.12.1, which is no longer maintained.

Installation

Kernel

Gerbera requires IP multicast support for automatic discovery by UPnP devices.

[*] Networking support --->
 Networking options --->
 [*] TCP/IP networking
 [*] IP: multicasting

Gerbera supports inotify, which is a file-monitoring mechanism that allows Gerbera to be notified about changes to files immediately. For more information, please consult the Gerbera trail operations documentation.

 File systems --->
 [*] Inotify support for userspace

USE flags

Emerge

After setting any USE configuration, proceed to install Gerbera:

Configuration

Network

• To set the network interface that Gerbera binds to, add the following to the GERBERA_OPTIONS variable, and substitute network_interface with the appropriate value e.g. GERBERA_OPTIONS="-e eth0"

GERBERA_OPTIONS="-e network_interface"

• To set the IP address that Gerbera binds to, add the following to the GERBERA_OPTIONS variable, and substitute ip_address with the appropriate value e.g. GERBERA_OPTIONS="-i 192.168.0.1"

GERBERA_OPTIONS="-i ip_address"

MySQL

• To enable MySQL support, set the enabled attribute to yes for the <mysql> element:

<mysqlenabled="yes">

• Set the enabled attribute to no for the <sqlite3> element:

<sqlite3enabled="no">

• Set the <host>, <database>, <username> and <password> elements:

<host>host</host>
<database>database</database>
<username>username</username>
<password>password</password>

• Login to MySQL and create the Gerbera database and user, using the host, database, username and password values set in the Gerbera configuration file:

Transcoding

Gerbera supports transcoding media files to formats that are supported by the UPnP device being used. The default Gentoo configuration file uses FFmpeg to transcode FLAC, Flash, Theora and Vorbis files. For more information, please consult the Gerbera transcoding configuration documentation.

• To enable transcoding support, set the enabled attribute to yes for the <transcoding> element:

<transcodingenabled="yes">

• For every additional mimetype that requires transcoding, add the following section in between the <mimetype-profile-mappings> and </mimetype-profile-mappings> elements and substitute mimetype and profile with the appropriate values e.g. <transcode mimetype="video/quicktime" using="video2mpeg"/>

<transcodemimetype="mimetype"using="profile"/>

• Install FFmpeg:

Alternative transcoders

Gerbera's transcoding support is very flexible and any application capable of transcoding can be used. For more information, please consult the Gerbera transcoding documentation.

VLC

Audio

• To enable VLC audio transcoding, replace the <agent> element for the audio2pcm profile with the following:

<agentcommand="vlc"arguments="%in -I dummy --sout=#transcode{acodec=s16b,ab=192,samplerate=44100,channels=2}:standard{access=file,mux=raw,dst=%out} vlc://quit"/>

• Set the <accept-url> element to yes for the audio2pcm profile:

<accept-url>yes</accept-url>

Video

• To enable VLC video transcoding, replace the <agent> element for the video2mpeg profile with the following:

<agentcommand="vlc"arguments="%in -I dummy --sout=#transcode{vcodec=mp2v,vb=4096,fps=25,acodec=mpga,ab=192,samplerate=48000,channels=2,audio-sync}:standard{access=file,mux=ps,dst=%out} vlc://quit"/>

• Set the <accept-url> element to yes for the video2mpeg profile:

<accept-url>yes</accept-url>

• Install VLC:

MPlayer

Video

• To enable MPlayer video transcoding, replace the <agent> element for the video2mpeg profile with the following:

<agentcommand="mencoder"arguments="%in -o %out -ovc lavc -oac lavc -lavcopts vcodec=mpeg2video:vbitrate=4096:vrc_minrate=0:vrc_maxrate=9800:vrc_buf_size=1835:keyint=15:vstrict=0:acodec=mp2:abitrate=192 -vf harddup -af lavcresample=48000:channels=2 -srate 48000 -ofps 25 -of mpeg -mpegopts format=mpeg2:tsaf"/>

• Set the <accept-url> element to yes for the video2mpeg profile:

<accept-url>yes</accept-url>

• Install MPlayer:

DLNA

• To enable DLNA support, set the extend attribute to yes for the <protocolInfo> element:

<protocolInfoextend="yes">

• For DLNA enabled TVs (e.g. Samsung), add the following section in between the <server> and </server> elements:

<custom-http-headers>
<addheader="transferMode.dlna.org: Streaming"/>
<addheader="contentFeatures.dlna.org: DLNA.ORG_OP=01;DLNA.ORG_CI=0;DLNA.ORG_FLAGS=01500000000000000000000000000000"/>
</custom-http-headers>

Video thumbnails

• To enable video thumbnail support, set the enabled attribute to yes for the <ffmpegthumbnailer> element:

<ffmpegthumbnailerenabled="yes">

• To overlay a filmstrip border on the generated thumbnail, set the <filmstrip-overlay> element to yes:

<filmstrip-overlay>yes</filmstrip-overlay>

• For DLNA enabled devices that support video thumbnails (e.g. PlayStation 3), set the extend attribute to yes for the <protocolInfo> element:

<protocolInfoextend="yes">

Raw images

• To enable (Canon CR2 and Nikon NEF) raw image support, enable transcoding and add the following section in between the <profile> and </profile> elements:

<profilename="raw2jpeg"enabled="yes"type="external">
<mimetype>image/jpeg</mimetype>
<accept-url>no</accept-url>
<first-resource>yes</first-resource>
<hide-original-resource>yes</hide-original-resource>
<use-chunked-encoding>no</use-chunked-encoding>
<agentcommand="/usr/local/bin/gerbera-raw2jpeg"arguments="%in %out"/>
<buffersize="524288"chunk-size="512"fill-size="1024"/>
</profile>

• Add the following section in between the <mimetype-profile-mappings> and </mimetype-profile-mappings> elements:

<transcodemimetype="image/raw"using="raw2jpeg"/>

• For every additional raw image format (supported by dcraw), add the following section in between the <extension-mimetype ignore-unknown="no"> and </extension-mimetype> elements, and substitute extension with the appropriate value e.g. <map from="kdc" to="image/raw"/>

<mapfrom="extension"to="image/raw"/>

• Since dcraw only outputs to stdout, the output will need to be redirected with the following script:

#!/bin/sh
DCRAW_PATH="/usr/bin/dcraw"
INPUT="1ドル"
OUTPUT="2ドル"
exec"${DCRAW_PATH}"-e-c"${INPUT}">"${OUTPUT}"

• Install dcraw:

Service

OpenRC

• To start Gerbera:

• To start Gerbera at boot:

systemd

Start Gerbera:

Start Gerbera at boot:

Troubleshooting

Mimetype mapping

Gerbera (via libmagic) may identify the mimetype of some files incorrectly. A common case is where videos with the mp4 extension are identified as the mimetype audio/mp4. To override the mimetype returned by libmagic, add the following section in between the <extension-mimetype ignore-unknown="no"> and </extension-mimetype> elements, and substitute extension and mimetype with the appropriate values e.g. <map from="mp4" to="video/mp4"/>

<mapfrom="extension"to="mimetype"/>

See also

• MiniDLNA — a media server aiming to be DLNA/UPnP-AV compliant.

References

• Media library
• Media server