Gerbera

Introduction
MediaTomb is an open source (GPL) UPnP MediaServer with a nice web user interface. It allows you to stream your digital media through your home network and access it on a variety of UPnP compatible devices.

Inotify
MediaTomb supports Inotify which is a file-monitoring mechanism that allows MediaTomb to be notified about changes to files immediately. For more information, please consult Section 2.1.5 of the MediaTomb User Interface documentation.


 * To enable Inotify support, build your kernel with the following options.

Installation

 * To install MediaTomb:

Network

 * To set the interface that MediaTomb binds to, add the following to the MEDIATOMB_OPTIONS variable.


 * To set the IP address that MediaTomb binds to, add the following to the MEDIATOMB_OPTIONS variable.

MySQL

 * To enable MySQL support, set the enabled attribute to yes for the   element.


 * Set the enabled attribute to no for the   element.


 * Set the  ,  ,   and   elements.

mysql> CREATE DATABASE database ; mysql> GRANT ALL ON database .* TO ' username '@' host ' IDENTIFIED BY ' password ';
 * Login to MySQL and create the MediaTomb database and user, using the host, database, username and password values set in the MediaTomb configuration file.

Transcoding
MediaTomb allows you to transcode unsupported media files to formats that are supported by your UPnP device. The default Gentoo configuration file uses FFmpeg to transcode FLAC, Flash, Theora and Vorbis files. For more information, please consult section 6.3 of the MediaTomb documentation.
 * To enable transcoding support, set the enabled attribute to yes for the   element.


 * For every additional mimetype that requires transcoding, add the following section in between the  and  elements and substitute mimetype and profile with the appropriate values e.g. 


 * Install FFmpeg.

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

VLC
Audio
 * To enable VLC audio transcoding, replace the   element for the audio2pcm profile with the following.


 * Set the  element to yes for the audio2pcm profile.

Video
 * To enable VLC video transcoding, replace the   element for the video2mpeg profile with the following.


 * Set the  element to yes for the video2mpeg profile.


 * Install VLC.

MPlayer
Video
 * To enable MPlayer video transcoding, replace the   element for the video2mpeg profile with the following.


 * Set the  element to yes for the video2mpeg profile.


 * Install MPlayer.

DLNA

 * To enable DLNA support, set the extend attribute to yes for the  element.


 * If you have a DLNA enabled TV (e.g. Samsung), add the following section in between the   and   elements.

Online Services
MediaTomb allows you to stream online content to your UPnP device from services such as YouTube. For more information, please consult Section 6.2.1 of the MediaTomb documentation.

YouTube

 * To enable YouTube support, set the enabled attribute to yes for the  element.


 * If you want to view YouTube videos in high definition (if available), set the hd attribute to yes for the  element.


 * If your UPnP device doesn't support MP4 videos, enable transcoding and add the following section in between the  and  elements.

Video Thumbnails

 * To enable video thumbnail support, set the enabled attribute to yes for the   element.


 * If you want to overlay a filmstrip border on the generated thumbnail, set the  element to yes.


 * If you have a DLNA enabled device that supports video thumbnails (e.g. PlayStation 3), set the extend attribute to yes for the  element.

Raw Images

 * To enable (Canon CR2 and Nikon NEF) raw image support, enable transcoding and add the following section in between the   and   elements.


 * Add the following section in between the  and  elements.


 * For every additional raw image format (supported by dcraw), add the following section in between the  and </extension-mimetype> elements and substitute extension with the appropriate value e.g. <map from&#61;"kdc" to&#61;"image/raw"/>


 * Create the following script.


 * Install dcraw.

Starting

 * To start MediaTomb.


 * To start MediaTomb at boot.

Mimetype Mapping
MediaTomb (via libmagic) can identify certain files with an incorrect mimetype. 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&#61;"no"> and </extension-mimetype> elements and substitute extension and mimetype with the appropriate values e.g. <map from&#61;"mp4" to&#61;"video/mp4"/>

Links

 * MediaTomb
 * MediaTomb FAQ