MediaTomb

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 variable.


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

MySQL

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


 * Set the 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 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  profile with the following.


 * Set the element to yes for the  profile.

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


 * Set the element to yes for the  profile.


 * Install VLC.

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


 * Set the element to yes for the  profile.


 * Install MPlayer.

DLNA

 * To enable DLNA support, set the 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 attribute to yes for the  element.


 * If you want to view YouTube videos in high definition (if available), set the 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 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 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  elements and substitute extension with the appropriate value e.g.


 * Create the following script.


 * Install dcraw.

Starting

 * To start MediaTomb.


 * To start MediaTomb at boot.

Requirements

 * (including the mediatomb-raw2jpeg script)
 * (including the mediatomb-raw2jpeg script)
 * (including the mediatomb-raw2jpeg script)

Supported Formats
* Available via transcoding.
 * Audio: AAC, FLAC*, M4A, MP3, Vorbis*, WAV, WMA.
 * Images: GIF, JPEG, PNG, Raw* (Canon CR2, Nikon NEF).
 * Video: AVI, DivX, Flash*, M2TS, MP4, MPEG-2, MKV*, Theora*, QuickTime*, WMV.

Configuration File
The following configuration file is optimised for the PlayStation 3 but should also work with other UPnP devices.

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  and  elements and substitute extension and mimetype with the appropriate values e.g. 

Links

 * MediaTomb
 * MediaTomb FAQ