Difference between revisions of "UPnP"

From MythTV Official Wiki
Jump to: navigation, search
(Moved Developers Notes on UPnP section to separate article)
m (Troubleshooting)
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''Universal Plug and Play''' ('''UPnP''') media sharing is an extremely easy method of sharing media (pictures/video/audio) on your network as it features automatic-discovery and does not require any configuration. As with most things which are very convenient, the security of any given implementation is an issue to which careful attention should be paid.
+
'''Universal Plug and Play''' ('''UPnP''') media sharing is an extremely easy method of sharing media (pictures/video/audio) on your network as it features automatic discovery and does not require any configuration. As with most things which are very convenient, the security of any given implementation is an issue to which careful attention should be paid.
  
 
== Introduction==
 
== Introduction==
Universal Plug and Play is a set of computer network protocols from the [http://www.upnp.org UPnP Forum]. The goals of UPnP are to allow UPnP devices on a network to detect each other and connect seamlessly, and to simplify the implementation of networks in the home (data sharing, communications, and entertainment) and corporate environments. The UPnP architecture supports zero-configuration, which implies no need for manual configuration on the user's end. There are typically three types of UPnP AV (Audio/Video) device control protocols (also called profiles); "UPnP AV MediaServer" whose sole purpose is to share content, "UPnP AV MediaRenderer" which renders content and exposes an interface to control the playback, and a "UPnP AV MediaServer ControlPoint" which can detect/find "UPnP AV MediaServers" and browse them to read media from them. A DMP (Digital Media Player) typically only implements a UPnP AV MediaServer ControlPoint, to be able to play files from UPnP AV MediaServers. For a more detailed explanation please read the "Developers notes on UPnP" at the bottom of this page.
+
Universal Plug and Play is a set of computer network protocols from the [http://www.upnp.org UPnP Forum]. The goals of UPnP are to allow UPnP devices on a network to detect each other and connect seamlessly, and to simplify the implementation of networks in the home (data sharing, communications, and entertainment) and corporate environments.
  
==UPnP in MythTV==
+
The UPnP architecture supports zero-configuration, which implies no need for manual configuration on the user's end. There are typically three types of UPnP AV (Audio/Video) device control protocols (also called profiles); "UPnP AV MediaServer" whose sole purpose is to share content, "UPnP AV MediaRenderer" which renders content and exposes an interface to control the playback, and a "UPnP AV MediaServer ControlPoint" which can detect/find "UPnP AV MediaServers" and browse them to read media from them. A DMP (Digital Media Player) typically only implements a UPnP AV MediaServer ControlPoint, to be able to play files from UPnP AV MediaServers.
MythTV [[Release_Notes_-_0.20|versions starting from 0.20]] have a built-in UPnP-server (a so called "UPnP AV MediaServer" device). UPnP AV MediaServers are where you store and share your media (pictures/videos/audio/music) from. So you can share MythTV media files to any UPnP-client (a so called "UPnP AV MediaServer ControlPoint" device) on your local-network, as long as that UPnP-client is not behind a firewall or you have opened the ports for UPnP in your firewall. That UPnP-client can then play those media files if it supports those MythTV codecs/container formats.
 
  
==Compatible UPnP AV MediaServer ControlPoints (UPnP clients)==
+
For a more detailed explanation see [[Developers Notes on UPnP]].
There are UPnP AV MediaServer ControlPoints (UPnP clients) available for most operating systems and many hardware platforms. UPnP AV MediaServer ControlPoints can be categorized as either software-based or hardware-based. Software-based UPnP clients can be run on PCs (personal computers), mainly on Win32, Linux, BSD, Unix or Mac platform. Hardware-based UPnP-clients may run on a stand-alone (or any specific hardware) DMP (Digital Media Player), like for example a DVD-player with built-in network-controller to stream media files over the network. Currently, there are more software-based UPnP clients than hardware-based ones, but chances are that will change in the future.
 
  
===UPnP-client software:===
+
==UPnP in MythTV==
* [http://andromote.de Andromote], a control point/Media Renderer for the Android Platform.
+
MythTV [[Release_Notes_-_0.20|versions starting from 0.20]] have a built-in UPnP server (a so called "UPnP AV MediaServer" device). UPnP servers are where you store and share your media (pictures/videos/audio/music) from. So you can share MythTV media files to any UPnP client (a so called "UPnP AV MediaServer ControlPoint" device) on your local-network, as long as the UPnP client is not behind a firewall or you have opened the ports for UPnP in your firewall. The UPnP client can then play those media files if it supports those MythTV codecs/container formats.
* [http://plugplayer.com PlugPlayer], a control point/Media Renderer for the iPhone and iPod touch.
 
* [http://www.snapstream.com/products/beyondtv/ SnapStream BTV/BeyondTV], a commercial Media Control/Renderer/Server and PVR for Windows.
 
* [http://www.nero.com Nero MediaHome (part of Nero Premium)], a commercial Media Control/Renderer/Server for Windows, (also features nice on-the-fly transcoding funcationlity and media organizing).
 
* [http://www.cyberlink.com/multi/products/main_12_ENU.html Cyberlink PowerCinema], a commercial Media Control/Renderer/Server for Windows, (also features nice media organizing funcationlity).
 
* [http://djmount.sourceforge.net/ djmount], a free open source Linux client, which presents all MediaServers in a filesystem so that files can be played using any media player.
 
* [http://geexbox.org/en/index.html GeeXboX], a free embedded Linux LiveCD-based Media Player distribution which can be used on an x86 or PowerPC hardware.  GeeXboX can also be installed to a disk drive, USB disk, or CF flash.
 
* [http://www.roxio.com/enu/solutions/mobile_media/default.html Media Manager], from Roxio, which is used for transferring media to smart phones, such as the Blackberry Curve.
 
* [http://users.pandora.be/bruno.keymolen/hmediamac.html MediaCloud], a player for Mac OS X (AppleTV plugin also available).
 
* [http://sourceforge.net/projects/platinum/ Platinum UPnP SDK], a cross-platform dual license open source/commercial UPnP Media Control/Renderer/Server SDK for Windows, Linux, Mac. (This is what [http://www.xboxmediacenter.com XBMC] uses).
 
* [http://opentools.homeip.net/dev-tools-for-upnp Intel UPnP AV open Test and Development Tools], UPnP UDP-Sniffer/Device-Spy/Device-Builder code generator.
 
* [http://xbmc.org/ XBMC]  (formerly X Box Media Center). Free client for XBox, Mac OS X, Linux and Windows. Has built in [http://xboxmediacenter.com/wiki/index.php?title=UPnP_Sharing UPnP] from the Platinum UPnP C++ SDK.
 
 
 
===UPnP-client hardware:===
 
UPnP client players have their own MythTV wiki page: [[UPnP Client Info]]
 
* [http://usa.asus.com/product.aspx?P_ID=sPkRGUeRrpiVYl5K Asus O!Play R1]
 
* [http://www.buffalotech.com/support/downloads/linktheater-wireless-g-high-definition-network-media-player-with-progressive-scan-dvd/ Buffalo PC-P3LWG/DVD] LinkTheater Wireless-G High Definition Network Media Player with Progressive Scan DVD
 
* [http://usa.denon.com/ProductDetails/2243.asp Denon AVR-4306], [http://usa.denon.com/ProductDetails/3510.asp Denon AVR-3808], [http://usa.denon.com/ProductDetails/3494.asp Denon AVR-4308], [http://usa.denon.com/ProductDetails/3755.asp Denon AVR-5308], 7.1 Home Theater MultiMedia A/V Receiver (music/audio only!), (stand-alone hardware player).
 
* [http://www.dlink.com/products/?pid=DSM-520 D-Link DSM-520], Wireless HD Media Player. MythTV wiki page: [[D-Link DSM-520 Wireless HD Media Player|D-Link DSM-520]]
 
* [http://www.freecom.com/productsubs.asp?CatID=8060&sCatID=1147457 Freecom MusicPal] Plays MP3 format audio only. Works out of the box with MythTV 0.21.
 
* [http://www.galaxymetalgear.com/Products/3500IPTV.html Galaxy IPTV 3500] A standalone player that connects to USB drives and UPnP sources automatically. HD capable, but no digital video out. MythTV wiki page: [[Galaxy3500IPTV-UPnP]]
 
* [http://www.iodata.com/usa/products/products.php?cat=HNP&ts=2&tsc=&sc=AVEL I-O DATA LinkPlayer2], A High Def capable DVD player, supports WMV and DivX as well as MPEG2 formats. MythTV Wiki page: [[IODataLinkPlayer2-UPnP]]
 
* [http://kbserver.netgear.com/products/mp101.asp Netgear MP101] A music only UPnP client.  Features built in wireless ethernet and LCD. MythTV wiki page: [[NetgearMP101-UPnP]]
 
* [http://www.netgear.com/Products/Entertainment/DigitalMediaPlayers/EVA700.aspx NETGEAR EVA700] Wireless Digital Media Adapter, supports HD MPEG-2 Transport Streams (recorded digital TV shows streamed directly from MythTV server).
 
* [http://www.pinnaclesys.com/PublicSite/uk/Products/Consumer+Products/Digital+Media+Adapters/Digital+Media+Player/ShowCenter+200 Pinnacle Showcenter 200], a wireless HD-capable media player, with some UPnP capability. MythTV wiki page: [[PinnacleShowcenter200-UPnP]]
 
* [http://www.zensonic.com Zensonic Z400] The zensonic Z400 works nicely and includes wireless capabilities.
 
* Nokia N82, [http://www.nseries.com/index.html#l=products,n95 N95] and other S60 phones, multimedia phones with WLAN and some UPnP capabilities. Can see the Mythtv server and list the recordings and the music, but can not play any of them.
 
* [[Sony PlayStation 3]]
 
* [[WD LIVE HD MEDIA PLAYER]]
 
* [http://us.zyxel.com/web/product_family_detail.php?PC1indexflag=20060802112123&CategoryGroupNo=PDCA2007032 ZyXEL DMA-1000], a wired, HD-capable media player.
 
  
===UPnP-clients software/hardware not yet tested with MythTV:===
+
==UPnP Clients==
* [http://www.slimdevices.com/su_downloads.html Slimserver]: a non-tested free open source UPnP-client (and server) from Slim Devices for Windows, Linux and Mac OSX. (Comment by news: Up to my knowledge they use their proprietary protocol and not uPnP)
+
UPnP AV MediaServer ControlPoints (UPnP clients) are available for most operating systems and many hardware platforms. UPnP clients can be categorized as either software-based or hardware-based. Software-based UPnP clients can be run on PCs (personal computers), mainly on Win32, Linux, BSD, Unix or Mac platform. Hardware based UPnP clients may run on a stand alone (or any specific hardware) DMP (Digital Media Player). For example, a DVD player with a ethernet interface to stream media files over the network.
* [http://gmrender.nongnu.org/ GMediaRender], a free open source UNIX/Linux media renderer.
 
* [http://www.jrmediacenter.com/ JRiver Media Center], a commercial Media Control/Renderer/Server for Windows.
 
* [http://en.wikipedia.org/wiki/Musicmatch_Jukebox Musicmatch Jukebox], a commercial MediaServer UPnP MediaServer and music-player for Windows.
 
* [http://www.nero.com/ Nero ShowTime], a commercial Media Control/Renderer/Server for Windows.
 
* [http://www.videolan.org/vlc/ VLC media player], a free open source cross-platform media player that has a UPnP-client (via the CyberLink UPnP plugin).
 
* [http://en.wikipedia.org/wiki/ WinAmp], a free closed source media player for Windows, using the commercial [http://www.on2share.com/ On2Share] UPnP plugin.
 
* [http://en.wikipedia.org/wiki/Windows_Media_Player Microsoft Windows Media Player (WMP)], a free closed source media player for Windows, using the commercial [http://www.on2share.com/ On2Share UPnP plugin].
 
* [http://www.dlink.com/products/?sec=0&pid=318 D-Link DSM-320], MediaLounge Wireless Media Player, (stand-alone hardware player).
 
* [http://www.dlink.com/products/?sec=0&pid=387 D-Link DSM-320RD], MediaLounge Wireless Media Player with DVD and Card Reader, (stand-alone hardware player).
 
* [http://netgear.com/Products/Entertainment/DigitalMediaPlayers/EVA8000.aspx NETGEAR EVA8000], a wireless HD-capable media player supporting a range of formats.
 
  
===UPnP-clients server/hardware not (yet?) compatible with MythTV:===
+
See [[UPnP Client Info]] for information on specific clients.
* [http://www.sonos.com Sonos Zone Player] is a UPnP-client which can't play its content on any non-Sonos device (it uses some propritory protocol to stream audio).
 
* [http://www.computervideo.net/nov04-1.html Elgato eyeHome] hardware is not a UPnP client. It seems to use the iRDMI (ShoutCast?) protocol, plus other proprietary stuff (ports 1055-1059)
 
* [http://www.archos.com/products/gen_5/archos_605wifi/index.html Archos 605] wifi plays music fine. It can browse videos, but many aren't playable. .VOB files seem to work.
 
* [http://openbossa.indt.org.br/canola/ Canola] has the ability to play audio from UPnP servers but the plugin specifically says MythTV is not supported.
 
* D-Link [http://www.dlink.com/products/?pid=653 DSM-330] DiVx Connected HD Media Player - UPnP not supported
 
* [http://www.xbox.com XBOX 360] According to GreyFoxx, this does not work  8/21/09 - Works perfect
 
  
 
==Troubleshooting==
 
==Troubleshooting==
 
* Make sure you set the proper external IP in mythtv-setup, otherwise you will be able to see your server via UPnP, but the file location urls will contain the default 127.0.0.1 IP address.
 
* Make sure you set the proper external IP in mythtv-setup, otherwise you will be able to see your server via UPnP, but the file location urls will contain the default 127.0.0.1 IP address.
 
* Make sure you have a value for <b>MusicLocation</b> and/or <b>VideoStartupDir</b> set for your backend hostname if your frontend and backend are on different machines.
 
* Make sure you have a value for <b>MusicLocation</b> and/or <b>VideoStartupDir</b> set for your backend hostname if your frontend and backend are on different machines.
* Make sure you have a route for 239.0.0.0/8 out your lan nic BEFORE mythbackend starts (route add -net 239.0.0.0/8 eth0).  It seems it won't work if you add the route later. Playstation 3's (ps3) take a while to find the backend, and searching can help, but the PS3 (f/w 2.17) isn't actually sending the packet everytime you search. You can tcpdump for udp packets to 239.255.255.250 to watch for it. `tcpdump ether host {ps3 mac addr}` also works well.
+
* Make sure you have a route for 239.0.0.0/8 out your lan nic BEFORE mythbackend starts (route add -net 239.0.0.0/8 eth0).  It seems it won't work if you add the route later.
 +
* The Playstation 3 can take a while to find the backend. Searching can help, but the PS3 (f/w 2.17) isn't actually sending the packet everytime you search. You can tcpdump for udp packets to 239.255.255.250 to watch for it. `tcpdump ether host {ps3 mac addr}` also works well.
 +
* If your UPnP client does not see your videos, and you are using a Storage Group for video, you must configure the frontend settings on your backend machine to point to the storage group path for videos. Go to Utilities/Setup->Setup->Media Settings->Video Settings->General. Change "Directories that hold videos" to point to the same directory as your video Storage Group.  This only applies to 0.24 and previous.  0.25 has been rewritten to use neither settings, and instead pull content from the existing content list populated by MythVideo, rather than populate its own list.
  
 
==See Also==
 
==See Also==
[[Developers Notes on UPnP]]
+
*[[Developers Notes on UPnP]]
 +
*[[UPnP Client Info]]
  
 
==External Links==
 
==External Links==

Revision as of 23:31, 15 January 2012

Universal Plug and Play (UPnP) media sharing is an extremely easy method of sharing media (pictures/video/audio) on your network as it features automatic discovery and does not require any configuration. As with most things which are very convenient, the security of any given implementation is an issue to which careful attention should be paid.

Introduction

Universal Plug and Play is a set of computer network protocols from the UPnP Forum. The goals of UPnP are to allow UPnP devices on a network to detect each other and connect seamlessly, and to simplify the implementation of networks in the home (data sharing, communications, and entertainment) and corporate environments.

The UPnP architecture supports zero-configuration, which implies no need for manual configuration on the user's end. There are typically three types of UPnP AV (Audio/Video) device control protocols (also called profiles); "UPnP AV MediaServer" whose sole purpose is to share content, "UPnP AV MediaRenderer" which renders content and exposes an interface to control the playback, and a "UPnP AV MediaServer ControlPoint" which can detect/find "UPnP AV MediaServers" and browse them to read media from them. A DMP (Digital Media Player) typically only implements a UPnP AV MediaServer ControlPoint, to be able to play files from UPnP AV MediaServers.

For a more detailed explanation see Developers Notes on UPnP.

UPnP in MythTV

MythTV versions starting from 0.20 have a built-in UPnP server (a so called "UPnP AV MediaServer" device). UPnP servers are where you store and share your media (pictures/videos/audio/music) from. So you can share MythTV media files to any UPnP client (a so called "UPnP AV MediaServer ControlPoint" device) on your local-network, as long as the UPnP client is not behind a firewall or you have opened the ports for UPnP in your firewall. The UPnP client can then play those media files if it supports those MythTV codecs/container formats.

UPnP Clients

UPnP AV MediaServer ControlPoints (UPnP clients) are available for most operating systems and many hardware platforms. UPnP clients can be categorized as either software-based or hardware-based. Software-based UPnP clients can be run on PCs (personal computers), mainly on Win32, Linux, BSD, Unix or Mac platform. Hardware based UPnP clients may run on a stand alone (or any specific hardware) DMP (Digital Media Player). For example, a DVD player with a ethernet interface to stream media files over the network.

See UPnP Client Info for information on specific clients.

Troubleshooting

  • Make sure you set the proper external IP in mythtv-setup, otherwise you will be able to see your server via UPnP, but the file location urls will contain the default 127.0.0.1 IP address.
  • Make sure you have a value for MusicLocation and/or VideoStartupDir set for your backend hostname if your frontend and backend are on different machines.
  • Make sure you have a route for 239.0.0.0/8 out your lan nic BEFORE mythbackend starts (route add -net 239.0.0.0/8 eth0). It seems it won't work if you add the route later.
  • The Playstation 3 can take a while to find the backend. Searching can help, but the PS3 (f/w 2.17) isn't actually sending the packet everytime you search. You can tcpdump for udp packets to 239.255.255.250 to watch for it. `tcpdump ether host {ps3 mac addr}` also works well.
  • If your UPnP client does not see your videos, and you are using a Storage Group for video, you must configure the frontend settings on your backend machine to point to the storage group path for videos. Go to Utilities/Setup->Setup->Media Settings->Video Settings->General. Change "Directories that hold videos" to point to the same directory as your video Storage Group. This only applies to 0.24 and previous. 0.25 has been rewritten to use neither settings, and instead pull content from the existing content list populated by MythVideo, rather than populate its own list.

See Also

External Links