UMSP

From WikiDLXTV
Revision as of 08:16, 20 May 2011 by Mad ady (Talk | contribs) (Added screenshots)

Jump to: navigation, search

UMSP is an internal UPnP Media Server based on PHP (for disclaimer and official thread see here, but the information is mostly outdated). It is integrated in the latest versions of WDLXTV firmware. (Requires at least version 0.4.1.9-6 of WDLXTV)

The server can be used to make any sort of multimedia content show up under the "Media Server" subitem (for both Video and Music). There's a subversion repository with some standard plugins. There's also the plugin forum.

UMSPx is a project meant to make the UMSP server hardware independent. You should be able to run it from a PC and use the same UMSP plugins with other UPnP devices (e.g. PS3, Xbox)


Features

Thru the use of plugins, the UMSP server can do the following:

  • directly play back video/audio/image content based on the content URL (but plugins add navigation support)
  • navigation and playback from various internet video sharing sites (e.g. Apple Trailers, Youtube, Vimeo, adult sites, Stagevu etc)
  • navigation and playback from internet image sharing sites (e.g. Google Picasa)
  • navigation and playback from music radios/sharing sites (e.g. Shoutcast, Grooveshark, etc)
  • integration and control with other media devices (e.g. Dreambox E2, Squeezebox, etc)
  • browse RSS/Atom feeds of content (e.g. Reader, Daily Podcasts, etc)
  • utility plugins can control various aspects of the wdtv (e.g. CD manager, Weather, PIN-Code, etc)
  • streaming from IPTV or from internet streaming sites is possible with some plugins (e.g Katrina, Freeview, etc)
  • most plugins support the search function (press search on your remote and type parts of the name you are searching). Refer to the plugin's forum thread to see how search works
  • the OSD allows you to view the content either as a list (in list view) or as thumbnails. You can toggle this by pressing the Options button on your remote

Plugins

The current plugin list is too dynamic to be listed here, but you can get "out of the box" the plugins from this repository: http://svn.wdlxtv.com/listing.php?repname=UMSP

Other plugins may be found in the forum because their use may be too limited or they might be under development, or require additional resources in order to work properly, so make sure you visit the forum regularly to find out what's going on. plugins

You can also have your own private plugins that you can keep on the wdtv and activate on reboot. (Details in the configuration section).

In terms of content playable on the WDTV through UMSP, check out this link (not up to date)

Setup

Activate UMSP

The UMSP server is activated by the /etc/init.d/S68umsp process. This process broadcasts a special packet to the WDTV so it can be discovered as a media server, and also downloads the selected plugins from the repository.

Firmwares up to 0.4.5.0

  • SSH/Telnet to your WDTV and execute these commands (or add them to S00custom-options):
config_tool -c UMSP=ON
config_tool -c APACHE=ON
config_tool -s
config_tool -s
  • Power cycle so the new webplugin settings get applied (and plugins are downloaded).

Firmwares after 0.4.5.0

  • You can enable UMSP from the web interface. Point your browser to http://<yourWDTV>/. Your default user/password for access is wdlxtv/wdlxtv. Click on the UMSP left icon to enable UMSP on startup.

Umsp-daemon.png

Configure plugins

There are several ways you can enable plugins and define what UMSP can run. Some methods imply logging in via telnet/ssh and executing commands on the wdtv, while other methods use the web interface exclusively. All methods are complementary, but you have a greater flexibility in using the commands.

You will see plugins on the OSD in this order:

  • hardcoded plugins (these come with UMSP even if you don't configure anything else - CD Manager, Shoutcast and BBC Podcasts)
  • plugins in umsp.php
  • plugins in umsp-items.xml
  • plugins configured via the web interface (in the order in which they were enabled)

Activate the plugins via the web interface (for 0.5.0 and greater)

  • TODO

Activate the plugins via the web interface (for 0.4.5.x - 0.4.7.x)

  • The plugins from the plugins svn repository are automatically downloaded when UMSP starts up. You can use the web interface (http://<yourWDTV>/) to go into Configuration -> UMSP and activate the plugins you want.
  • Most plugins have additional parameters that can be set here
  • For 0.4.7.x firmwares you can select additional repositories in the web interface as well. The plugins from these repositories will be automatically downloaded on reboot.

Umsp-plugins-0.4.7.3.png

Manually define plugins/items via umsp.php

  • if you create a file called /conf/umsp.php you can manually enable plugins or add extra content. Here is a sample file
<?php
global $myMediaItems;
$myMediaItems[] = array(   
 'id'         => 'umsp://plugins/vimeo/vimeo',   #Attribute of item
 'dc:title'      => 'Vimeo',
 'upnp:class'   => 'object.container',
 'upnp:album_art'=> 'http://lh4.googleusercontent.com/_CsOEwmjx9p8/Ta19IwkHBDI/AAAAAAAAO8w/gBEPQ7dnKTc/vimeo-logo.png',
);

$myMediaItems[] = array(   
 'id'         => 'umsp://plugins/daily-podcasts/daily-podcasts',   #Attribute of item
 'dc:title'      => 'Daily Podcasts',
 'upnp:class'   => 'object.container',
 'upnp:album_art'=> 'http://www.todayfm.com/Images/Podcasting%20Icon%20200.jpg',
);

$myMediaItems[] = array(   
 'id'    => 'umsp://plugins/testimage',
 'dc:title'     => 'Secret image',
 'res'          => 'http://www.isc.tamu.edu/~lewing/linux/sit3-shine.7.gif',
 'upnp:class'   => 'object.item.imageItem',
 'protocolInfo' => '*:*:*:*'
);
?>
  • You can get additional details in the plugin development section
  • When passing parameters on the id line, you must make sure your string is urlencoded (percent-escape every non allowed character - including ampersand - &). If in doubt use this link to generate your URL: http://www.albionresearch.com/misc/urlencode.php. Failing to escape your id will lead to "No content" being displayed when you try to navigate.
  • If you want to get rid of the hardcoded plugins, you can reset them by creating a file with this content:
<?php
global $myMediaItems;
$myMediaItems = array(); //unset the hardcoded plugins
?>

Manually define plugins/items via umsp-items.xml

  • TODO


Plugin Development

  • detailed instructions on how to develop plugins for UMSP can be found here and here


Troubleshooting

If for some reason UMSP doesn't show up you may have to load it manually like so:

  • Browse to the webinterface (go to http://<yourWDTV>/umsp/index.php) and click "Send SSDP broadcast".

Most plugins log their errors inside /tmp/umsp-log.txt. You can also activate debugging in most plugins and get more messages in the same log file.

You can also test the enabled plugins in a browser to pick up any errors by going to http://<yourWDTV>/umsp/umsp-test.php

Credits to zoster and b-rad