Difference between revisions of "UPnP"

From Official Kodi Wiki
Jump to: navigation, search
(minor grammatical correction)
m
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
{{mininav| [[Video library]] {{l2| [[Music library]] }} | [[Media sources]] }}
+
{{mininav|[[Video library]] {{l2| [[Music library]] }} | [[File sharing]] }}
<section begin="intro" />Kodi has several built-in UPnP A/V {{small|''(Universal Plug and Play Audio Visual)''}} features, including the ability to receive UPnP and DLNA content pushed to Kodi, browse UPnP and DLNA media sources, sharing a Kodi library with other UPnP and DLNA devices, and even controlling UPnP and DLNA devices. UPnP is also the easiest way to share a library from one Kodi device to another.<section end="intro" />
 
  
  
 +
= Introduction=
  
[[w:Universal Plug and Play#UPnP AV standards|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 Kodi 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> - Kodi's UPnP server abilities
 
  
 +
= Settings =
 +
{{Kodi}} UPnP is disabled by default and must be activated before use.
  
* <big>'''[[UPnP/Client]]'''</big> - Kodi 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 Kodi from one device (as a [[UPnP/Server|server]]) to another Kodi 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.
 
  
  
{{Isengard updated}}
+
= 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>
  
[[Category:Index]]
+
 
[[Category:Manual]]
+
 
 +
= 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:Video library]]
[[Category:UPnP|*]]
+
[[Category:Music library]]
[[Category:File sharing]]
 

Latest revision as of 04:02, 19 August 2020

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


1 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.


2 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


3 Create UPnP Source in Client


4 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