Gerbera

Kernel

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

<nowiki />
[*] 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.

<nowiki />
    File systems --->
      [*] Inotify support for userspace

USE flags

Emerge

After setting any USE configuration, proceed to install Gerbera:

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"

<syntaxhighlight lang="bash">GERBERA_OPTIONS="-e network_interface"</syntaxhighlight>

• 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"

<syntaxhighlight lang="bash">GERBERA_OPTIONS="-i ip_address"</syntaxhighlight>

MySQL

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

<syntaxhighlight lang="xml"><nowiki />
      <mysql enabled="yes"></syntaxhighlight>

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

<syntaxhighlight lang="xml"><nowiki />
      <sqlite3 enabled="no"></syntaxhighlight>

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

<syntaxhighlight lang="xml">
        <host>host</host>
        <database>database</database>
        <username>username</username>
        <password>password</password>
</syntaxhighlight>

• 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:

<syntaxhighlight lang="xml"><nowiki />
  <transcoding enabled="yes"></syntaxhighlight>

• 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"/>

<syntaxhighlight lang="xml"><nowiki />
      <transcode mimetype="mimetype" using="profile"/></syntaxhighlight>

• Install FFmpeg:

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

<syntaxhighlight lang="xml">
        <accept-url>yes</accept-url>
</syntaxhighlight>

<syntaxhighlight lang="xml"><nowiki />
        <agent command="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"/></syntaxhighlight>

<syntaxhighlight lang="xml">
        <accept-url>yes</accept-url>
</syntaxhighlight>

<syntaxhighlight lang="xml"><nowiki />
        <agent command="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"/></syntaxhighlight>

<syntaxhighlight lang="xml">
        <accept-url>yes</accept-url>
</syntaxhighlight>

DLNA

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

<syntaxhighlight lang="xml"><nowiki />
    <protocolInfo extend="yes"></syntaxhighlight>

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

<syntaxhighlight lang="xml"><nowiki />
    <custom-http-headers>
      <add header="transferMode.dlna.org: Streaming"/>
      <add header="contentFeatures.dlna.org: DLNA.ORG_OP=01;DLNA.ORG_CI=0;DLNA.ORG_FLAGS=01500000000000000000000000000000"/>
    </custom-http-headers></syntaxhighlight>

Video thumbnails

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

<syntaxhighlight lang="xml"><nowiki />
      <ffmpegthumbnailer enabled="yes"></syntaxhighlight>

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

<syntaxhighlight lang="xml">
        <filmstrip-overlay>yes</filmstrip-overlay>
</syntaxhighlight>

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

<syntaxhighlight lang="xml"><nowiki />
    <protocolInfo extend="yes"></syntaxhighlight>

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:

<syntaxhighlight lang="xml"><nowiki />
      <profile name="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>
        <agent command="/usr/local/bin/gerbera-raw2jpeg" arguments="%in %out"/>
        <buffer size="524288" chunk-size="512" fill-size="1024"/>
      </profile></syntaxhighlight>

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

<syntaxhighlight lang="xml"><nowiki />
      <transcode mimetype="image/raw" using="raw2jpeg"/></syntaxhighlight>

• 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"/>

<syntaxhighlight lang="xml"><nowiki />
        <map from="extension" to="image/raw"/></syntaxhighlight>

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

<syntaxhighlight lang="bash">#!/bin/sh

DCRAW_PATH="/usr/bin/dcraw"
INPUT="$1"
OUTPUT="$2"

exec "${DCRAW_PATH}" -e -c "${INPUT}" > "${OUTPUT}"</syntaxhighlight>

• Install dcraw:

Service

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"/>

<syntaxhighlight lang="xml"><nowiki />
        <map from="extension" to="mimetype"/></syntaxhighlight>