Difference between revisions of "MediaTomb"

From ArchWiki
Jump to: navigation, search
m (Usage)
(update to reflect recent changes after move to [community])
Line 17: Line 17:
 
== Installation ==
 
== Installation ==
  
MediaTomb is available in the [[Arch User Repository]]: {{Package AUR|mediatomb}}. The latest development version is also available via {{Package AUR|mediatomb-svn}}.
+
MediaTomb is available in [community]:
 +
 
 +
# pacman -S mediatomb
 +
 
 +
The latest development version is also available via {{Package AUR|mediatomb-svn}} (outdated?).
  
 
== Configuration ==
 
== Configuration ==
  
Following installation, users should run {{Codeline|mediatomb}} in a terminal to generate a default server configuration file ({{Filename|~/.mediatomb/config.xml}}). The default settings may be sufficient for many users, though changes are required for PlayStation 3 support. Press Ctrl+C to terminate the server after the initial run.
+
The default settings may be sufficient for many users, though changes are required for PlayStation 3 support. MediaTomb may be configured and run per-user or as a system-wide daemon. Following installation, either run
 +
 
 +
$ mediatomb
 +
 
 +
to start MediaTomb as the current user and generate a default configuration in {{Filename|~/.mediatomb/config.xml}}, or
 +
 
 +
# /etc/rc.d/mediatomb
 +
 
 +
to start the MediaTomb daemon and generate a default configuration in {{Filename|/var/lib/mediatomb/.mediatomb/config.xml}}. The following notes assume MediaTomb is running as a system-wide daemon.
  
 
For PlayStation 3 support, users must set {{Codeline|<nowiki><protocolInfo extend="yes"/></nowiki>}}. An "avi" mimetype mapping should also be uncommented for DivX support.
 
For PlayStation 3 support, users must set {{Codeline|<nowiki><protocolInfo extend="yes"/></nowiki>}}. An "avi" mimetype mapping should also be uncommented for DivX support.
  
 
{{File
 
{{File
|name=~/.mediatomb/config.xml
+
|name=/var/lib/mediatomb/.mediatomb/config.xml
 
|content=<nowiki>
 
|content=<nowiki>
 
...
 
...
Line 42: Line 54:
  
 
{{File
 
{{File
|name=~/.mediatomb/config.xml
+
|name=/var/lib/mediatomb/.mediatomb/config.xml
 
|content=<nowiki>
 
|content=<nowiki>
 
...
 
...
Line 53: Line 65:
 
Users may customize the import script to fine-tune the virtual layout. The [http://mediatomb.cc/dokuwiki/scripting:scripting Scripting] section of the MediaTomb wiki provides several examples. Starting with the built-in script available at {{Filename|/usr/share/mediatomb/js/import.js}}:
 
Users may customize the import script to fine-tune the virtual layout. The [http://mediatomb.cc/dokuwiki/scripting:scripting Scripting] section of the MediaTomb wiki provides several examples. Starting with the built-in script available at {{Filename|/usr/share/mediatomb/js/import.js}}:
  
  $ cp /usr/share/mediatomb/js/import.js ~/.mediatomb/
+
  $ cp /usr/share/mediatomb/js/import.js /var/lib/mediatomb/.mediatomb/
  
... and edit {{Filename|~/.mediatomb/import.js}} as desired. To utilize the customized script, users must set {{Codeline|<nowiki><virtual-layout type="js"></nowiki>}} and specify the script's location.
+
...and edit {{Filename|/var/lib/mediatomb/.mediatomb/import.js}} as desired. To utilize the customized script, users must set {{Codeline|<nowiki><virtual-layout type="js"></nowiki>}} and specify the script's location.
  
 
{{File
 
{{File
|name=~/.mediatomb/config.xml
+
|name=/var/lib/mediatomb/.mediatomb/config.xml
 
|content=<nowiki>
 
|content=<nowiki>
 
...
 
...
  
 
<virtual-layout type="js">
 
<virtual-layout type="js">
   <import-script>/home/username/.mediatomb/import.js</import-script>
+
   <import-script>/var/lib/mediatomb/.mediatomb/import.js</import-script>
 
</virtual-layout>
 
</virtual-layout>
  
Line 71: Line 83:
 
== Usage ==
 
== Usage ==
  
After configuring MediaTomb to your liking, restart the server by running the {{Codeline|mediatomb}} command in a terminal:
+
After configuring MediaTomb to your liking, restart the server by running
 
 
{{Command
 
|name=mediatomb
 
|output=<nowiki>
 
MediaTomb UPnP Server version 0.11.0 - http://mediatomb.cc/
 
 
 
===============================================================================
 
Copyright 2005-2008 Gena Batsyan, Sergey Bostandzhyan, Leonhard Wimmer.
 
MediaTomb is free software, covered by the GNU General Public License version 2
 
 
 
2010-03-02 12:13:54    INFO: Loading configuration from: /home/user/.mediatomb/config.xml
 
2010-03-02 12:13:54    INFO: Checking configuration...
 
2010-03-02 12:13:54    INFO: Setting filesystem import charset to UTF-8
 
2010-03-02 12:13:54    INFO: Setting metadata import charset to UTF-8
 
2010-03-02 12:13:54    INFO: Setting playlist charset to UTF-8
 
2010-03-02 12:13:54    INFO: Configuration check succeeded.
 
2010-03-02 12:13:54    INFO: Initialized port: 49152
 
2010-03-02 12:13:54    INFO: Server bound to: 192.168.1.50
 
2010-03-02 12:13:55    INFO: MediaTomb Web UI can be reached by following this link:
 
2010-03-02 12:13:55    INFO: http://192.168.1.50:49152/
 
</nowiki>}}
 
  
As shown, MediaTomb will output a link to its web interface. Enter this link in your favorite browser (JavaScript required) to access the web interface and begin importing media.
+
# /etc/rc.d/mediatomb restart
  
MediaTomb can be run as a daemon, if desired. An appropriate script is included with the package at {{Filename|/etc/rc.d/mediatomb}}. Prior to starting the daemon, users should specify their username in {{Filename|/etc/conf.d/mediatomb}} so the daemon uses the appropriate configuration and database files.
+
The daemon listens on port 50500 by default. To access the web interface and begin importing media, navigate to http://127.0.0.1:50500/ in your favorite browser (JavaScript required).

Revision as of 18:19, 12 September 2010

Template:Article summary start Template:Article summary text Template:Article summary heading Template:Article summary wiki Template:Article summary end

From MediaTomb - Free UPnP MediaServer:

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 listen to/watch it on a variety of UPnP compatible devices.

MediaTomb enables users to stream digital media to UPnP compatible devices like the PlayStation 3 and Xbox 360. Several alternatives exist, such as FUPPES, ps3mediaserver, and uShare. One of MediaTomb's distinguishing features is the ability to customize the server layout based on extracted metadata (scriptable virtual containers); MediaTomb is highly flexible.

Installation

MediaTomb is available in [community]:

# pacman -S mediatomb

The latest development version is also available via Template:Package AUR (outdated?).

Configuration

The default settings may be sufficient for many users, though changes are required for PlayStation 3 support. MediaTomb may be configured and run per-user or as a system-wide daemon. Following installation, either run

$ mediatomb

to start MediaTomb as the current user and generate a default configuration in Template:Filename, or

# /etc/rc.d/mediatomb

to start the MediaTomb daemon and generate a default configuration in Template:Filename. The following notes assume MediaTomb is running as a system-wide daemon.

For PlayStation 3 support, users must set Template:Codeline. An "avi" mimetype mapping should also be uncommented for DivX support.

Template:File

When importing media to the database, MediaTomb will create a virtual container layout as defined by the Template:Codeline option. That is, media will be organized according to metadata (album, artist, etc.) through creation of virtual database objects. If your media is already organized on the file system, you may disable this feature to significantly improve import performance:

Template:File

Users may customize the import script to fine-tune the virtual layout. The Scripting section of the MediaTomb wiki provides several examples. Starting with the built-in script available at Template:Filename:

$ cp /usr/share/mediatomb/js/import.js /var/lib/mediatomb/.mediatomb/

...and edit Template:Filename as desired. To utilize the customized script, users must set Template:Codeline and specify the script's location.

Template:File

Usage

After configuring MediaTomb to your liking, restart the server by running

# /etc/rc.d/mediatomb restart

The daemon listens on port 50500 by default. To access the web interface and begin importing media, navigate to http://127.0.0.1:50500/ in your favorite browser (JavaScript required).