Archive:UPnP/Media source

From Official Kodi Wiki
Revision as of 09:45, 11 July 2006 by >UPnP4XBMC
Jump to navigation Jump to search

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 introduction

UPnP (short for "Universal Plug and Play") is a set of computer network protocols from the UPnP Forum. The goals of UPnP are to allow devices to connect seamlessly and to simplify the implementation of networks in the home and corporate environments. UPnP achieves this by defining and publishing UPnP device control protocols built upon open, internet-based communication standards, (which means that any devloper/programmer can make a device or software for any operating-system/platform in any program-language by folling the UPnP standard and it will automaticly be compatible with all other UPnP devices).


UPnP in XBMC

XBMC has (since the 10 of July 2006) a built-in UPnP-client (a so called "UPnP MediaRenderer") which can auto-detect any UPnP-server (a so called "UPnP MediaServer") on your local-network, as long as that UPnP-server is not behind a firewall or you have opened the ports for UPnP in your firewall. You can very simply add one or more UPnP shares via the "Add Source" function with the context-menu (white-button on your controller) in XBMC under each of the the My Pictures/My Videos/My Music sections.


Compatible UPnP MediaServers (UPnP-servers)

UPnP MediaServers are available for most operating-systems, examples are:

  • Windows Media Connect, Microsoft's free UPnP MediaServer for Windows.
  • Slimserver: a free open source UPnP MediaServer from Slim Devices for Windows, Linux and Mac OSX.
  • Rhapsody, by real, a commercial Media Control/Renderer/Server for Windows and Macintosh.
  • Allegro Media Server, a free closed source UPnP MediaServer for Windows and Macintosh.
  • TwonkyVision, by TwonkyMedia, a free closed source UPnP Media Server for Windows and Linux.
  • TVersity, a free closed source UPnP AV Media Server for Windows.
  • On2Share, a commercial MediaServer UPnP AV MediaServer plugin for MCE (Microsoft Windows Media Center).
  • SnapStream BTV/BeyondTV, a commercial Media Control/Renderer/Server and PVR for Windows.
  • Cyberlink PowerCinema, a commercial Media Control/Renderer/Server for Windows.
  • ushare, a free open source UPnP Media Server for Linux and NSLU2.
  • mediatomb, a free open source UPnP Media Server for Linux.
  • PyMedS, a free open source Python UPnP MediaServer.
  • AwoX, provides a family of commercial UPnP products and solutions.


Installing and Configuring Windows Media Connect on your PC

This step-by-step tutorial will walk you through the installation and setup of Windows Media Connect, a free UPnP MediaServer for Windows. In order to use this option, you need to have the following:

  • An XBMC build newer than 10 July 2006
  • Windows Media Connect from Microsoft, available here or here.

The first step is to download and install Windows Media Connect on your computer. This easy-to-use software allows you to share media (pictures, videos, music/audio) on your PC using the UPnP protocol, which is also supported by many standalone network players.

After installing Windows Media Connect, simply run the included setup utility included with it. The first screen that appears should look something like the one to the right. For now, simply choose Next.

Wmc1.jpg

Wmc2.jpg

The next step is to choose which folders are going to be shared with XBMC. It offers you the option of using the default folders. In this case, we are going to choose which folders to share.

Also, be sure to select Automatically start folder sharing when Windows starts.

Next, choose the folders that you would like to share, by selecting Add and choosing as many folders as you like. You can share entire drives or just individual folders. In this example, I have shared my Music folder.

After you are done, select Finish. You should now see a Windows Media Connect icon in your tray, indicating that the server is running.

Wmc3.jpg

Setting up UPnP Shares in XBMC

Configuring UPnP Shares in XBMC is as easy as setting up any other type of share. 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.

Wmc4.jpg

File:Wmc5.jpg

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.

Wmc6.jpg

Wmc7.jpg

You should see Unknown Device appear, as is displayed to the left. Select the device and choose Allow.

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.


Developers notes on UPnP

If you are a C/C++ programmer and like to make a UPnP MediaServer or improve on XBMC's UPnP MediaRenderer (or even add new UPnP features to XBMC) then we recommend you checkout the Platinum UPnP SDK, available on SourceForge.net. Platinum UPnP SDK is a free and open source software development kit that let you easily create a UPnP MediaServer or MediaRenderer, it also happens to be from this SDK that XBMC got its client code from, (XBMC's UPnP MediaRenderer was also firstly implemented into XBMC by the author of the Platinum UPnP SDK, Sylvain a.k.a. c0diq). You should also visit the official UPnP™ Forum. Other good links for developers can be found at the bottom of the UPnP article on Wikipedia.