Archive:UPnP/Media source: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(THe steps below don't work if UPnP isn't enabled... I just made that clear.)
(32 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{cleanup}}
{{mininav|[[UPnP]]}}
{{see also|UPnP/Server|HOW-TO:Share libraries using UPnP}}
<section begin="intro" />Kodi can use UPnP as a [[media sources]] from any device that has a UPnP server. UPnP media servers are available for most operating systems and many hardware platforms. Kodi itself can be a [[UPnP server]].<section end="intro" />
UPnP media sharing is an extremely easy method of sharing your media (pictures/video/audio) on your network as it features automatic-discovery and does not require any configuration.


UPnP (short for "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, without the need for manual configuration on the users end, and then be able to share/stream data (usually video and audio files). For a more detailed explanation on the inner working of UPnP please read the "[[UPnP Sharing#Developers notes on UPnP|Developers notes on UPnP]]" section at the end of this article. There are three main types of UPnP AV (Audio/Video) device control protocols (also called profiles); there is the "UPnP AV MediaServer" which sole purpose is to share content, and there rhe "UPnP AV MediaRenderer" which render content to exposes an interface to control the playback, and then there is the "UPnP AV MediaServer ControlPoint" which can detect/find "UPnP AV MediaServer" and browse them to read media/data from them. A DMP (Digital Media Player) like XBMC typically only implements the "UPnP AV MediaServer ControlPoint" device profile.
Currently, due to technical limitations (dynamic file paths) UPnP file sources can't be scanned into the local library. However, since many UPnP servers can provide metadata as well as the files themselves, then this may not be an issue.


The drawback is that an upnp Server only sends metadata and so it is not possible to integrate the upnp shares into the XBMC library.<br />
== Setting up UPnP file sources in Kodi ==
UPnP file sources can be used in videos, music, and pictures. Configuring UPnP file sources in Kodi is as easy as setting up any other type of file source, such as [[SMB]] or [[NFS]].


== UPnP in XBMC ==
<b>Before you begin...</b> you need to enable UPnP support for your client. Go into Settings > Services > UPnP/DLNA and turn on the switch for "Enable UPnP Support".  After that's done, follow the steps below to add each UPnP source.
XBMC has (since the 10th of July 2006) a built-in UPnP-client (a so called "UPnP AV MediaServer ControlPoint" device) which can auto-detect any UPnP-server (a so called "UPnP AV MediaServer" device) on your local-network as long as that UPnP-server is not behind a firewall/router or you have opened the ports needed for UPnP in your firewall/router. XBMC also have a built-in UPnP-server (since the 24th of January 2007) which enables you to share your video/picture/audio files to all XBMC boxes on your local-network. XBMC's built-in UPnP-server can also stream those same video/picture/audio files to other UPnP-clients ("UPnP AV MediaServer ControlPoint" devices) but those UPnP-clients that do not support broadcast discovery of UPnP-servers might still be able to stream from XBMC's UPnP-server if they support manual entering of the IP-address that your XBMC box is using).<br />


=== DLNA compliance in XBMC ===
<gallery widths=500px heights=313px>
DLNA certificate guidelines are governed by the [http://www.dlna.org Digital Living Network Alliance]. Since September 2007 XBMC's built-in UPnP-server and UPnP-client are compatible with DLNA CERTIFIED™ devices.  
File:Share-upnp-library.jpg|'''Step 1:''' Go into ether Videos, Music, or Picture file views, depending on the content you want to add, and use the "Add" button to bring up this window.<br />'''Step 2:''' Then click on the "Browse" button on the right hand side.
File:Share-upnp-library2.png|'''Step 3:''' This new window will pop up. Scroll down and select "UPnP Devices"
File:Share-upnp-library3.png|'''Step 4:''' All available UPnP servers on your network should show up here. If a source/server doesn't show up, it might be blocked by one of the other UPnP servers due to a misconfiguration. Select the source you wish to add.
File:Share-upnp-library4.png|'''Step 5:''' At this window please select the kind of content you want to add. In that case, we choose "Video Library".
File:Share-upnp-library5.png|'''Step 6:''' This window will let you select if you would like to add "Files", "Movies", "Playlists" or "TV shows". Please choose what you want to add. In our case here, we select "Movies".
File:Share-upnp-library6.png|'''Step 7:''' Now please select "Title". You can of course select something else according to what you want to add. It's easily possible to only add a specific genre via UPnP in that way for example.
File:Share-upnp-library7.png|'''Step 8:''' The next window looks a bit confusing. Don't worry if you don't see any files. That's normal. Please select "OK"
File:Share-upnp-library8.png|'''Step 9:''' At this window you are able to give the source a specific name if you want (yellow square). If you choose to do so, select "OK" after you are done.
File:Share-upnp-library9.jpg|'''Step 10:''' Now, we're done and you will see the source added under the "Videos" location from the Kodi main menu. You should now be able to see the same video which are shown on the UPnP server.
</gallery>


There are two classes of DLNA CERTIFIED™ devices:
{{Krypton updated}}
* Digital Media Servers (DMS) record and/or store media content, then share it on the network. (Sharing is sometimes limited by content protection rules.) Some examples of DMS products are advanced set-top boxes, digital video recorders, PCs/laptops, music servers with hard disk drives, broadcast tuners, video and imaging capture devices such as cameras and camcorders, and multimedia mobile phones.
* Digital Media Players (DMP) can find and play/display the content that is shared by DMS devices. Some examples of DMP products are digital TV monitors, stereo systems, home theaters, printers, personal digital assistants, multimedia mobile phones, wireless monitors and game consoles.
The DLNA guidelines are very flexible. Some devices offer rich user interfaces and some do not. With some server devices you can also manage your media collection or manage other devices on the network. Some devices can be both a player and server device, e.g. a computer running XBMC can play files from another server and share the computer's own local files to other players.


== Compatible UPnP MediaServers (UPnP-servers) ==
[[Category:File sharing]]
UPnP AV MediaServers (UPnP-servers) is where you store and share your media (pictures/videos/audio/music) files from. There are UPnP MediaServers available for most operating-systems and many hardware-platforms, and those UPnP AV MediaServers can be either be categorized as 'software-based' or 'hardware-based'. Software-based MediaServers can be run on PC (personal-computer), mainly on Win32, Linux, BSD, Unix or Mac operating-systems platforms. And, hardware-based MediaServers may run on any [[NAS (Network Attached Storage)]] or any specific hardware designed for delivering media, like for example a PVR (Personal Video Recorder) or DVR (Digital Video Recorder) set-top box. Currently, there are more software-based MediaServers than hardware-based, but chances are that will change in the near future as UPnP becomes a more popular standard for network connectivity.
[[Category:Manual]]
 
[[Category:UPnP]]
=== UPnP MediaServer software ===
* Feel free to add any tested UPnP AV MediaServer (UPnP-server) software compatible with XBMC to this list.
** More untested UPnP-servers can be found here => http://en.wikipedia.org/wiki/UPnP_AV_MediaServers
==== Free UPnP MediaServers ====
* [[UPnP/Server|XBMC Media Center]] (Linux/Mac/Windows), XBMC builds have since the 24th of January 2007 had a built-in UPnP MediaServer.
* [http://www.microsoft.com/windows/windowsmedia/devices/wmconnect/default.aspx Windows Media Connect], Microsoft's free closed source UPnP MediaServer for Windows.
* [http://www.microsoft.com/windows/windowsmedia/player/11/default.aspx Windows Media Player 11], Microsoft's WMP version 11 for Windows has a built-in closed source UPnP MediaServer
* [http://www.tversity.com TVersity], a free closed source UPnP AV Media Server for Windows, (also features nice on-the-fly transcoding funcationlity and can share internet audio/video contents too).
* [http://www.streamium.philips.com Philips Media Manager (Streamium)], a free closed source UPnP MediaServer for Windows and Macintosh. '''Note:''' The Macintosh version has been in beta since 2004 and downloads an update hidden in %user/.Philips/MediaManager/updates/3.1.4.0000.exe which should be renamed to 3.1.4.0000.dmg and mounted. It will also constantly request to download the update. ''(from [http://www.streamiumcafe.com/ubbthreads/showflat.php?Cat=0&Number=10918&an=0&page=0#10918 Streamium OSX support forum])''
* [http://ushare.geexbox.org GeeXboX ushare], a free open source UPnP MediaServer for Linux and [http://en.wikipedia.org/wiki/NSLU2 NSLU2].
* [http://www.nongnu.org/gmediaserver/ GMediaServer], a free open source UPnP MediaServer for Linux.
* [http://mediatomb.sf.net/ MediaTomb], a free open source UPnP MediaServer for Linux.
* [http://www.cybergarage.org/net/index.html CyberMediaGate], a free open source UPnP MediaServer for Windows/Macintosh/Linux/UNIX, (reference implementation of UPnP MediaServer integrates into [http://www.mythtv.org MythTV] PVR for Linux)
* [http://resnet.uoregon.edu/~gurney_j/jmpc/pymeds.html PyMedS], a free open source Python UPnP MediaServer for Windows/Macintosh/Linux/UNIX.
* [http://www.cidero.com/radioServer.html Cidero Internet Radio Server], a free open source Java UPnP MediaServer for Windows/Macintosh/Linux/UNIX (Internet Radio Server only, SHOUTcast by default).
* [http://sourceforge.net/projects/platinum/ Platinum UPnP SDK], a dual license open source/commercial UPnP Media Control/Renderer/Server SDK for Windows, Linux, Mac. This is what XBMC uses.
* [http://coherence.beebits.net/ Coherence], a free UPnP/DLNA MediaServer written in Python.
* [http://lundman.net/wiki/index.php/Llink llink], a free UPNP Media Server for Mac OS X, Windows, Linux, Unix, Embedded NAS, Media Players (NMT, popcornhour etc).
 
==== Commercial UPnP MediaServers ====
* [http://www.mezzmo.com Mezzmo], by Conceiva, a commercial DLNA/UPnP Media Server and Media Organizer for Windows with on-the-fly transcoding functionality.
* [http://www.twonkyvision.com TwonkyMedia], by TwonkyVision, a commercial UPnP Media Server for Windows and Linux, (can interface with the third-party applications iTunes, WinAmp, and Adobe Photoshop Album, and work as plugin to give those applications UPnP-server function), it can even run as a background service on Windows.
* [http://www.on2share.com On2Share], a commercial UPnP MediaServer plugin for MCE (Microsoft XP Windows Media Center Edition).
* [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 functionality 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 functionality).
* [http://elgato.com/index.php?file=products_eyeconnect Elgato AV Media Streaming Server], a commercial UPnP MediaServer plugin for EyeTV (Elgato PVR software for Macintosh), (also features nice media organizing functionality).
* [http://www.awox.com/ AwoX], provides a family of commercial UPnP products and solutions.
* [http://www.themediamall.com/playon PlayOn (by MediaMall)], a UPnP MediaServer with built-in transcoder which enable you to watch Internet video from services and websites including Netflix, Hulu, CBS, ESPN and many more. (PlayOn is still Beta but a fully featured release is coming soon).
* [http://www.allegrosoft.com/ams.html Allegro Media Server (AMS)], a closed source UPnP MediaServer for Windows and Macintosh, (can interface with the third-party application iTunes, and work as plugin to give iTunes a UPnP-server). A time limited demo is available, registration is $39.95.
* [http://www.majesticdotapp.com/ Majestic], a UPNP AV Media server for Mac OS X. Current versions are Intel only, but previous versions work on PPC as well. 10-day trial.
* [http://arkmc.com/ ArkMC], a UPnP/DLNA multimedia software application for iOS (iPhone, iPad, iPod Touch) and Android. Limited functionality free trial.
 
=== UPnP MediaServer hardware ===
* [http://en.wikipedia.org/wiki/NSLU2 NSLU2], a hacked/modded version running [http://ushare.geexbox.org/ ushare] (a free open source UPnP MediaServer for Linux), (connect USB 2.0 drives to the NSLU2 and share).
* [http://www.dlink.com/products/?pid=277 D-Link DSM-G600 wireless storage enclosure], (connect USB 2.0 drives to the NSLU2 and share).
* [http://www.maxtor.com/portal/site/Maxtor/menuitem.6adb6b8313633595062e6be791346068/?channelpath=/en_us/Products/Network%20Storage/Maxtor%20Shared%20Storage%20Family Maxtor Shared Storage Family].
* [http://www.dlink.com/products/?pid=277 D-Link DSM-602H 20GB Central Home Drive].
* [http://www.mediabolic.com/press/item.php?id=343 Buffalo Media Server].
* [http://netgear.com/Products/Storage/ReadyNASDuo/RND2000.aspx?detail=Specifications Netgear ReadyNAS Duo], (features room for 2 internal hot swapable SATA-drives, supports RAID-0/1 (Xraid) )
* [http://www.infrant.com/products_ReadyNAS600.htm Infrant ReadyNAS X6/600], (features room for four internal IDE/ATA-drives, supports RAID-0/1/5)
* [http://www.synology.com/enu/products/index.php Synology NAS stations].
 
== Setting up UPnP Shares in XBMC ==
Configuring UPnP shares in XBMC is as easy as setting up any other type of share. First you need to activate XBMC's UPnP-client with "Enable UPnP Client" from the network section under settings in XBMC GUI. Then you simply add one or more UPnP shares via the "'''Add Source'''" function with the context-menu ("c" key on a keyboard or the info button on some remotes) in XBMC GUI under each of the the My Pictures/My Videos/My Music sections (just like how you add [[Windows File Sharing (samba/smb)|SMB/Samba]] shares).<br /><br />
 
In this example, we are going to add the Music folder shared above to My Music, although you can use the exact same procedure to add a share to My Videos or My Pictures:
{|
|
First, open My Music. Your screen should look something like the one displayed to the right, although your shares may be different.
|
[[File:wmc4.jpg|300px]]
|}
{|
|
[[File:wmc5.jpg|300px]]
|
Then, open the context menu by pressing the White button on your controller and select '''Add Source'''.
|}
{|
|
Then choose '''Browse''' and then '''Add Network Location'''. Choose Windows Media Connect as the Protocol and then Browse for the Server Address. Select the UPnP:// option and then you should see your computer's name. Select your computer and at this time, a help balloon should appear in the tray on your computer advising you that a new device has been connected.
|
[[File:wmc6.jpg|300px]]
|}
{|
|
[[File:wmc7.jpg|300px]]
|
You should see Unknown Device appear, as is displayed to the left. Select the device and choose '''Allow'''.<br /><br />Back on your Xbox, you may have to press back (the B button) and reselect your computer name in order to make the shares appear. Then, select the share that appears and name it. At this point, the share whould appear in My Music.
|}
 
== Installing and Configuring Windows Media Connect on your PC ==
{{see|HOW-TO:Install and configure Windows Media Connect}}
 
== [UNDERCONSTRUCTION] Vista (or WINXP) + Windows Media Player 11 Configuration ==
{{see|HOW-TO:Share XBMC libraries to Windows Media Player}}
 
== Developers notes on UPnP ==
{{See|UPnP/Developer notes}}
 
[[Category:File Sharing]]
[[Category:XBMC Manual]]

Revision as of 14:30, 24 March 2019

Home icon grey.png   ▶ UPnP ▶ Media source

Kodi can use UPnP as a media sources from any device that has a UPnP server. UPnP media servers are available for most operating systems and many hardware platforms. Kodi itself can be a UPnP server.

Currently, due to technical limitations (dynamic file paths) UPnP file sources can't be scanned into the local library. However, since many UPnP servers can provide metadata as well as the files themselves, then this may not be an issue.

Setting up UPnP file sources in Kodi

UPnP file sources can be used in videos, music, and pictures. Configuring UPnP file sources in Kodi is as easy as setting up any other type of file source, such as SMB or NFS.

Before you begin... you need to enable UPnP support for your client. Go into Settings > Services > UPnP/DLNA and turn on the switch for "Enable UPnP Support". After that's done, follow the steps below to add each UPnP source.