UPnP: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
XBMC has (since 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).
{{mininav|[[Video library]] {{l2| [[Music library]] }} | [[File sharing]] }}




= Introduction=


[[w:UPnP|UPnP]] may refer to:
<section begin="intro" />{{Kodi}} can be used as a UPnP Server that will stream its library contents to other players on the network, or it can be used as a UPnP Client that can receive music and video from a UPnP Server on the network. <section end="intro" />


When using UPnP...
* The client player does not have direct access to the video and music files. It relies on the UPnP server to send a '''browse tree''' that will display on the client player.
* The UPnP Server cotrols the appearance of what is displayed in the browse tree which varies between different UPnP servers.
* The browse tree can provide a series of nodes through which you can browse the content (year, title, actors, artists, albums etc).
* If using the {{kodi}} UPnP Server, these browse tree nodes are based on the {{Kodi}} library nodes and you can create additional nodes in the {{kodi}} server to expand the browse tree.


*<big>'''[[UPnP/Media source]]'''</big> - A type of media source that can be added in XBMC to receive videos from a UPnP server
'''Note:''' UPnP file sharing cannot be used to create a {{kodi}} library on the client device. You can only browse and play from the Browse Tree.


{{warning|UPnP has inherent security risks. If your router has the UPnP setting enabled, then malicious actors may be able to access your network. You should be able to disable UPnP in your router, but still use UPnP on your local network.}}


*<big>'''[[UPnP/Server]]'''</big> - XBMC's UPnP server abilities


= Settings =
{{Kodi}} UPnP is disabled by default and must be activated before use.


*<big>'''[[UPnP/Client]]'''</big> - XBMC as an UPnP/DLNA client ("play to" target)
If you intend to use {{kodi}} as the UPnP Server, then select the {{Kodi}} installation that has the fully scanned/scraped library that you would like shared to your other devices.


Then setup Clients to receive the UPnP video and music libraries from the Server. You would not normally set your {{Kodi}} install as both a Server and Client.


*<big>'''[[HOW-TO:Share libraries using UPnP]]'''</big> - How to share XBMC from one device (as a [[UPnP/Server|server]]) to another XBMC device (as a [[UPnP/Media source|media source]]).
UPnP settings can be found in {{highlight|bordered=yes|[[Settings/Services/UPnP_DLNA|'''Settings -> Services -> UPnP / DLNA''']]}}


For an explanation of the settings see... '''[[Settings/Services/UPnP_DLNA]]'''


*<big>'''[[UPnP/Developer notes]]'''</big> - Notes for developers.


[[Category:Index]]
 
= Create UPnP Source in Client =
<gallery mode="packed" widths="500px" heights="283px">
File:Quick-start-2.1.png|'''Step 1:''' From '''Videos>Files''' select '''Add videos...'''<br />
File:Share-upnp-library.jpg|'''Step 2:''' Click '''Browse'''
File:Share-upnp-library2.png|'''Step 3:''' Select '''UPnP Devices'''
File:Share-upnp-library3.png|'''Step 4:''' All available UPnP servers on your network should show up here. Select the UPnP server you wish to add. If a server is not listed you may have incorrectly adjusted your settings
File:Share-upnp-library4.png|'''Step 5:''' Select which content to be added.
File:Share-upnp-library5.png|'''Step 6:''' Choose which method to use. '''Files''' will require you to constantly select a Source to browse. '''Movies / TV Shows''' will provide the full library list of movies/tv shows. '''Playlist''' Allows you to curate lists to browse.
File:Share-upnp-library6.png|'''Step 7:''' If selecting '''Movies / TV Shows''' in the previous step, further refine how to browse the listing or press '''OK''' to always browse from this point
File:Share-upnp-library7.png|'''Step 8:''' If you chose to further refine, press '''OK''' on this screen. At this point it is normal for the list to be empty
File:Share-upnp-library8.png|'''Step 9:''' If required, you can change the name of the Source. Either way, select '''OK'''
File:Share-upnp-library9.jpg|'''Step 10:''' Setup is complete. Browsing via UPnP is performed from this screen, or add the Source to your Favourites list, or create a [[Custom home items|New main menu item]].
</gallery>
 
 
 
= Stream to Clients =
{{kodi}} can also be a Control Point in addition to being a UPnP server, allowing you to select which client will commence playback of the currently selected title.
 
To enable and use this features
# On the {{kodi}} server enable the setting '''Look for remote UPnP players''' in {{highlight|bordered=yes|[[Settings/Services/UPnP_DLNA|Settings → Services → UPnP / DLNA]]}}.
# When browsing on the {{kodi}} server, call up the [[Basic_controls#Context_Menu|Context Menu]]
# Select '''Play with...''' and a list of UPnP clients will be listed.
# Select the client that will be used for playback
# If playing to a {{kodi}} client, ensure the client has the setting '''Allow control of Kodi via UPnP''' enabled in {{highlight|bordered=yes|[[Settings/Services/UPnP_DLNA|Settings → Services → UPnP]]}}.
 
 
 
{{top}}
 
 
{{updated|18}}
 
[[Category:Karellen]]
[[Category:File_sharing]]
[[Category:Video library]]
[[Category:Music library]]

Revision as of 04:02, 19 August 2020

Home icon grey.png   ▶ Video library
▶ Music library
▶ File sharing ▶ UPnP


Introduction

Kodi can be used as a UPnP Server that will stream its library contents to other players on the network, or it can be used as a UPnP Client that can receive music and video from a UPnP Server on the network.

When using UPnP...

  • The client player does not have direct access to the video and music files. It relies on the UPnP server to send a browse tree that will display on the client player.
  • The UPnP Server cotrols the appearance of what is displayed in the browse tree which varies between different UPnP servers.
  • The browse tree can provide a series of nodes through which you can browse the content (year, title, actors, artists, albums etc).
  • If using the Kodi UPnP Server, these browse tree nodes are based on the Kodi library nodes and you can create additional nodes in the Kodi server to expand the browse tree.

Note: UPnP file sharing cannot be used to create a Kodi library on the client device. You can only browse and play from the Browse Tree.

Stop hand.png UPnP has inherent security risks. If your router has the UPnP setting enabled, then malicious actors may be able to access your network. You should be able to disable UPnP in your router, but still use UPnP on your local network.


Settings

Kodi UPnP is disabled by default and must be activated before use.

If you intend to use Kodi as the UPnP Server, then select the Kodi installation that has the fully scanned/scraped library that you would like shared to your other devices.

Then setup Clients to receive the UPnP video and music libraries from the Server. You would not normally set your Kodi install as both a Server and Client.

UPnP settings can be found in Settings -> Services -> UPnP / DLNA

For an explanation of the settings see... Settings/Services/UPnP_DLNA


Create UPnP Source in Client


Stream to Clients

Kodi can also be a Control Point in addition to being a UPnP server, allowing you to select which client will commence playback of the currently selected title.

To enable and use this features

  1. On the Kodi server enable the setting Look for remote UPnP players in Settings → Services → UPnP / DLNA.
  2. When browsing on the Kodi server, call up the Context Menu
  3. Select Play with... and a list of UPnP clients will be listed.
  4. Select the client that will be used for playback
  5. If playing to a Kodi client, ensure the client has the setting Allow control of Kodi via UPnP enabled in Settings → Services → UPnP.


Return to top