Sources.xml/Types: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
← Older edit
>Scape
 
(158 intermediate revisions by 28 users not shown)
Line 1: Line 1:
There are two main types of bookmarks, Local and Network. In addition, there are specialty bookmarks that are only available in certain sections of XBMC. (Such as My Programs or My Music)
{{cleanup}}
There are two main types of sources, Local and Network. In addition, there are specialty sources that are only available in certain sections of Kodi, (such as in [[Music_library]] or [[Video_library]]).


== Sources with multiple paths / targets ==
It is possible to let a media source point to more than one target or path. You can accomplish this through the User Interface or by directly editing the sources.xml. One example from the Videos section of the default Sources.xml file.
<pre>
  <source>
    <name>01 Movies</name>
    <path pathversion="1">F:\Kodi\Movies HD\</path>
    <path pathversion="1">E:\Kodi\Movies SD\Movies New\</path>
  </source>
</pre>
The '''pathversion="1"''' parameter means it was written with a more recent version of Kodi. It's to ensure that saved paths can be reliably updated if/when a new way to store them is implemented (e.g. old paths using Q: are now stored using special://xbmc etc).


==Local Bookmarks==
You can have multiple paths in '''local''', [[SMB]] and [[NFS]] sources, not for the other protocols.
===Basic Bookmarks===
{|
| valign="top" |
Local bookmarks are ones that reference the local xbox hard drive, dvd-rom drive or memory cards.


Simply use standard DOS drive:/path syntax for your path.
== Local Sources ==
=== Basic Sources ===
Local sources are ones that point to the local available drives like hard disks, memory cards, optical drive, etc. Kodi can play audio CDs from DVD drives as well as Video-DVD's. Kodi has a built in audio CD ripper. This ripper supports ripping to wav, mp3 and OGG vorbis formats and attempts to name your tracks using data sourced from CDDB.com.


'''C D E F G''' are all valid xbox drives to access
== Generic Network Sources ==
Network sources reference remote shares of various types. Kodi supports SMB (windows file sharing, also known as Samba or CIFS), among others. These generic network sources are supported in all Kodi sections in Kodi ("'''Music'''", "'''Videos'''", "'''Pictures'''", and "'''Filemanager'''"). You can also add multiple paths (<path></path>) in each source. See [[File_sharing|Sharing media from your PC]] how to configure such servers yourself.


'''H I J K L M N O''' are the memory card ports (but fair warning XBMC's memory card support is little to none)
=== Windows File Sharing (SMB/SAMBA/CIFS) ===
[[SMB]] sharing is the most common and probably the best performing sharing solution for Kodi. It supports domains and workgroups as well.


'''X Y Z''' are cache partitions and should not need to be referenced for any reason
{{note|For much more information about using SMB/SAMBA/CIFS in Kodi, see the [[File_sharing]] article.}}


|
The full syntax for sharing is as follows:
<xml>
  <bookmark>
    <name>Local E Drive</name>
    <path>e:/media/movies/</path>
  </bookmark>
</xml>
|}


<pre>
  <source>
    <path>smb://domain;username:password@computername_or_ipaddress/sharename/path</path>
  </source>
</pre>


===Advanced Special Bookmarks===
''domain'' - If you use a domain controller you may enter it here
 
''username'' - The username used to authenticate with the server
 
''password'' - The password used to authenticate with the server


XBMC has the option to force the DVD drive to read the disk as a iso9660 or UDF filesystem.<br>
''computername/ipaddress'' - As long as a name server is available on the network computer names *should* work. If any connectivity issues are encountered when using computer names replace it with the direct IP address of the computer.
If you have the need for these functions simply use the following bookmarks:
<xml>
  <bookmark>
    <name>ISO</name>
    <path>iso9660://</path>
  </bookmark>


  <bookmark>
''sharename'' - Share name on the remote server
    <name>UDF</name>
    <path>UDF://</path>
  </bookmark>
</xml>


''path'' - path relative to the share


==Network Bookmarks==
If any variables are not needed omit the required punctuation.<br />
Network bookmarks reference remote shares of various types. XBMC supports SMB (windows file sharing), XBMS (also known as CCX), among others.  
Examples (where "USER" is the user-name, "12345" is the password, and "192.168.0.200" is the IP-address of the server):


For a direct link to a server use:
<pre>
  <source>
    <path>smb://USER:[email protected]</path>
  </source>
</pre>


===Windows File Sharing (SMB/SAMBA/CIFS)===
For a direct link to a share on a server use:
<pre>
  <source>
    <path>smb://USER:[email protected]/share/</path>
  </source>
</pre>


SMB sharing is the most common and best performing sharing solution for XBMC. It supports domains and workgroups as well. The full syntax for sharing follows,
For a direct link to a subfolder under a share on a server use:
<pre>
  <source>
    <path>smb://USER:12345@192.168.0.200/share/path/</path>
  </source>
</pre>


'''smb://domain;username:password@computername_or_ipaddress/sharename/path'''
For a direct link to all servers in your workgroup/domain use (for this you must have entered your username, password and workgroup/domain in the Kodi GUI first):
<pre>
  <source>
    <path>smb://</path>
  </source>
</pre>


''domain'' - If you use a domain controller you may enter it here
=== Network Filesystem (NFS) ===
[[NFS]] sharing is the a full alternative to SMB sharing. It allows the the same features by reaching a better performance (due to less protocol overhead). Also there is no need to save any account information (username, password) inside the xml files, because NFS authentication is done via UID of the user running Kodi and the access rights granted for this UID on the NFS exported filesystem.
 
{{note|For much more information about using NFS in Kodi, see the [[NFS]] article.}}
 
The full syntax for sharing is as follows:


''username'' - The username used to authenticate with the server
<pre>
  <source>
    <path>nfs://ipaddress/exported_path</path>
  </source>
</pre>


''password'' - The password used to authenticate with the server
''ipaddress'' - At the moment there is no name resolution possible. Use the direct IP address of the NFS server for now.


''computername/ipaddress'' - As long as a name server is available on the network computer names *should* work. If any connectivity issues are encountered when using computer names replace it with the direct IP address of the computer.
''exported_path'' - The absolute path on the NFS server. The exported_path can be the exported path or exported path including subfolders. At least one of the exported paths of the NFS server should be found inside the the exported_path.


''sharename'' - Share name on the remote server
For a direct link to a server for getting a list of exported paths do (exchange IP with the one from your NFS server in the example below):
<pre>
  <source>
    <path>nfs://192.168.0.200</path>
  </source>
</pre>


''path'' - path relative to the share
=== UPnP (Universal Plug and Play) ===
UPnP (short for "Universal Plug and Play") 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. The UPnP-client in Kodi (also called "UPnP AV Media Server Control Point") supports direct links to the server/shares and auto-discovery of servers available on the local network. UPnP require a UPnP-server (also called "UPnP AV Media Server"), UPnP AV Media Servers is where you store and share your media (pictures/videos/audio/music) from. There are UPnP Media Servers available for most operating-systems and many hardware-platforms, UPnP AV Media Servers can be either be categorized as software-based or hardware-based. Software-based Media Servers can be run on PC (personal-computer), mainly on Windows, Linux, BSD, Unix or Mac platform. And, hardware-based Media Servers may run on any NAS (Network Attached Storage) or any specific hardware for delivering media, like for example a PVR (Personal Video Recorder) device.


For auto-discovery (default in Kodi) use the following share:<br />
<pre>
  <source>
    <path>upnp://</path>
  </source>
</pre>


If any variables are not needed omit the required punctuation.<br>
For a direct link to a server use:<br />
Examples (where "xbox" is the user-name and "12345" is the password):
<pre>
  <source>
    <path>upnp://ip_address:1901</path>
  </source>
</pre>


For a direct link to a server use:<br>
For a direct link to a specific share on a server use:
'''smb://192.168.0.200/19'
<pre>
  <source>
    <path>upnp://ip_address:1901/share/</path>
  </source>
</pre>


For a direct link to share on a server use:<br>
For a direct link to a subfolder under a share on a server use:
'''smb://xbox:[email protected]/share/'''
<pre>
  <source>
    <path>upnp://ip_address:1901/share/path/</path>
  </source>
</pre>


For a direct link subfolder under share on a server use:<br>
=== FTP (File Transfer Protocol) Client ===
'''smb://xbox:12345@192.168.0.200/share/path/'''
Kodi also contains an FTP-client with which you can add sources in all sections in Kodi interface. (Remember that the default FTP-port is usually 21).


Example (if any variables are not needed, omit the required punctuation):
<pre>
  <source>
    <!--to connect as anonymous use ftp://ip:port/-->
    <path>ftp://username:password@ipaddress:port/folder/</path>
  </source>
</pre>


===UPnP (Universal Plug and Play)===
=== SFTP (SSH File Transfer Protocol) Client ===


[[UPnP Sharing|UPnP (short for "Universal Plug and Play")]] 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. The UPnP-client in XBMC (also called "UPnP AV MediaServer ControlPoint") supports direct links to the server/shares and auto-discovery of servers available on the local network. UPnP require a UPnP-server (also called "UPnP AV MediaServer"), UPnP AV MediaServers is where you store and share your media (pictures/videos/audio/music) from. There are UPnP MediaServers available for most operating-systems and many hardware-platforms, 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 platform. And, hardware-based MediaServers may run on any NAS (Network Attached Storage) or any specific hardware for delivering media, like for example a PVR (Personal Video Recorder) device. For more information about using UPnP, see [[UPnP Sharing]].
<pre>
  <source>
    <name>Remote SFTP Videos</name>
    <path>sftp://username:password@server.com/share/videos/</path>
  </source>
</pre>


For auto-discovery (default in xbmc) use the following share:<br>
=== HTTP (Hypertext Transfer Protocol ) Client ===
'''upnp://'''
Kodi also contains an HTTP-client with which you can add sources in all sections in the Kodi interface.


For a direct link to a server use:<br>
Example (if any variables are not needed, omit the required punctuation):
'''upnp://ip_address:1901'''
<pre>
  <source>
    <!--to connect as anonymous use "http://ipaddress:port/" or just "http://ipaddress"-->
    <path>http://username:password@ipaddress:port/directory/|option1=value1&option2=value2</path>
  </source>
</pre>


For a direct link to spesific share on a server use:<br>
Examples of options include "auth", which is required if your HTTP server uses any type of authentication other than basic (which is, in fact, unsafe unless used over HTTPS). E.g. if your HTTP server uses digest authentication, use <code><nowiki>http://username:password@host:port/directory/|auth=digest</nowiki></code>. For maximum flexibility, use <code>auth=any</code> or <code>auth=anysafe</code> (i.e. anything other than basic).
'''upnp://ip_address:1901/share/'''


For a direct link subfolder under share on a server use:<br>
Other options include:
'''upnp://ip_address:1901/share/path/'''
* Referrer
* User-Agent
* Cookie
* Encoding


===XBMS Protocol (CCX/ccXStream)===
For the meanings of these, see RFC 2616.


XBMSP (XBox Media Stream Protocol) was developed by PuhPuh and is a very user-friendly protocol. The XBMSP-client in XBMC supports direct links to the server/shares and auto-discovery of servers available on the local network. XBMSP (or "XBMS" for short) require that you run a XBMSP-server on your computer, XBMSP-servers are also known as "CCX" or "ccXStream" servers. For more information about using XBMS, see [[Windows ccx gui (xbms)|Configuring XBMS Shares]].
=== RSS Feeds ===
[http://en.wikipedia.org/wiki/RSS RSS] (which stands for "''Really Simple Syndication"'') is a family of web feed formats used to publish frequently updated works—such as blog entries, news headlines, audio, and video—in a standardized format. An RSS document is commonly called a "''RSS feed''", "''RSS channel''", or "''Web feed''", includes full or summarized text, plus metadata such as publishing dates and authorship. [http://en.wikipedia.org/wiki/Podcast Podcasts] is a is a series of audio or video digital-media files which is distributed over the Internet by such RSS feeds, and [http://en.wikipedia.org/wiki/Video_podcast Video Podcasts] are often referred to as "''Vidcast''" or "''Vodcast''".


For autodiscover (default in xbmc) use the following share:<br>
Kodi features a built RSS Feed Reader Client for such audio and video sources, this type of media source will connect to the RSS feed you enter and lists the video or audio available to stream with thumbnails and metadata if available.
'''xbms://'''
<br />


For a direct link to a server use:<br>
{{note|Please make sure you have read the [[RSS_media_source|RSS Feeds in Kodi Guide]].}}
'''xbmc://ip_address:1400'''


For a direct link to spesific share on a server use:<br>
<pre>
'''xbmc://ip_address:1400/share/'''
  <source>
    <name>RSS Feed</name>
    <path>rss://</path>
  </source>
</pre>


For a direct link subfolder under share on a server use:<br>
=== WebDAV ===
'''xbmc://ip_address:1400/share/path/'''
You can either connect Kodi to a WebDAV-Server via an unencrypted ''dav'' (HTTP) or an encrypted ''davs'' (HTTPS) connection.
If you choose to connect Kodi to your WebDAV server via its IP address instead of its hostname, then you are forced to choose an unencrypted ''dav'' (HTTP) connection.
This is due to Kodi's WebDAV client implementation, where an encrypted ''davs'' (HTTPS) connection is always associated to a vaild SSL certificate which yet is associated to a WebDAV server's host-/domainname.
In other words: If you choose to connect via an encrypted ''davs'' (HTTPS) connection, you are forced to connect via your WebDAV server's host-/domainname instead of its IP address '''and''' you will need a valid SSL certificate securing/validating your ''davs'' (HTTPS) connection. Depending on whether you are using a reverse web proxy server or not and on how it is configured, the according SSL certificate mostly has to be installed directly on your WebDAV server. Be aware that self-signed certificates do '''not''' work as they will be revoked by the Kodi WebDAV client, you can get a valid SSL certificate provided by an official certificate authority, for example "Let's encrypt".


Example unencrypted ''dav'' (HTTP):
<pre>
  <source>
    <name>Remote WebDAV videos</name>
    <path>dav://username:[email protected]/share/videos/</path>
  </source>
</pre>


===ReplayTV sharing===
Example encrypted ''davs'' (HTTPS):
<pre>
  <source>
    <name>Remote WebDAV videos</name>
    <path>davs://username:[email protected]/share/videos/</path>
  </source>
</pre>


[http://www.replaytv.com ReplayTV] is a stand-alone PVR/DVR (Personal Video Recoder/Digital Video Recoder) box, (a rival to [http://www.tivo.com TiVo]). ReplayTV  records TV (and sheduele recoding) to its built-in harddrive and stores it there, and via it's network-port the ReplayTV box can share that stored video on a local network. XBMC has a DVArchive-client which can auto-detect and browse such shares. Note that the system-clock on the ReplayTV box and the Xbox much match within a minute for streaming to work so be sure you set the correct date/time on both the Xbox and the ReplayTV box before you begin, (remember that the Xbox does not have a clock-battery so its date/time if it loases power for more than a couple of minutes).
== Plugin Sources ==
A plugin source is a special type of source that is powered by a python script automatically run by Kodi. A plugin source is typically used to represent the online content of a website as a hierarchical file system.  


For autodiscover (default in xbmc) use the following share:<br>
Kodi supports 3 types of plugin sources: video, music, and pictures. Plugins are placed in the "plugins\<type of media>" folder within the Kodi folder.
'''rtv://*/'''


Plugin sources can be added from within Kodi through the [[Add-on_manager| Addon Manager]], accessible from the "Settings" menu option on the home screen.


==My Music-Specific Bookmarks==
The actual file that is invoked by Kodi is "plugins\<type of media>\<name of plugin>\default.py". This file must be present for the plugin to show up in "Add Source" the dialog.
===Microsoft Soundtracks ===
{|
| valign="top" |
The Microsoft dashboard contains the ablity to rip your cd's to WMA format. This type of bookmark (enabled by default in xbmc) allows you to read the MS database and play those tracks
|
<xml>
  <bookmark>
    <name>MS Soundtracks</name>
    <path>soundtrack://</path>
  </bookmark>
</xml>
|}


== Videos Specific Sources ==
=== Video Library ===
This special source allows you to access the video database without switching to [[Video_library|library]] view. This is useful for remote browsing of the video library, i.e. via the [[Web_interface|web interface]].


===iTunes Network Share (DAAP)===
<pre>
{|
   <source>
|
     <name>Library</name>
iTunes contains a method of sharing its database. XBMC can play all unprotected files. This means purchased music CANNOT be played in xbmc. To enable sharing in iTunes look under the edit tab, click on preferences, click on sharing and enable the sharing checkbox. To enable itunes sharing in xbmc edit the path of the following bookmark with the ip address of the PC you wish to connect to. Note that you CANNOT use computer names in this field. For more information about setting up iTunes shares, see [[iTunes (Daap)|Configuring Itunes Shares]]
     <path>videodb://</path>
|
   </source>
<xml>
</pre>
   <bookmark>
     <name>iTunes Network Share (DAAP)</name>
    <nowiki><!-- only use an IP address here !--></nowiki>
     <path>daap://192.168.1.100</path>
   </bookmark>
</xml>
|}


<div id="shoutcast"></div>.
=== HDHomeRun ===
This type of media source will connect to a HDHomeRun (Networked Digital Cable TV/HDTV Tuner) box and allows you to watch Live TV directly from Kodi.<br />


<pre>
  <source>
    <name>HDHomeRun</name>
    <path>hdhomerun://</path>
  </source>
</pre>


===Shoutcast Top 500 Streams===
== Music Specific Sources ==
{|
=== Music Library ===
| valign="top" |
This special source allows you to access the music database without switching to Music Library view. This is useful for remote browsing of the music library, i.e. via the [[Web_interface|web interface]].
This type of bookmark will contact www.shoutcast.com and list the top 500 webradio streams provided by them. This bookmark is available in My Music by default
|
<xml>
  <bookmark>
    <name>SHOUTcast Top 500</name>
    <path>shout://www.shoutcast.com/</path>
  </bookmark>
</xml>
|}


<pre>
  <source>
    <name>Library</name>
    <path>musicdb://</path>
  </source>
</pre>


===Forced CDDA===
=== Forced CDDA ===
{|
Kodi employs auto-detection of the type of CD or DVD disks in the drive. If for some reason you wish to have a share that forces Kodi to read the disk as an CDDA AudioCD (Compact Disk Digital Audio) use the following share.
| valign="top" |
<pre>
XBMC employs auto detection of the type of cd or dvd in the drive. If for some reason you wish to have a share that forces the xbox to read the disk as an audio-cd (compact disk digital audio) use the following share.
   <source>   
|
<xml>
   <bookmark>   
     <name>CDDA</name>
     <name>CDDA</name>
     <path>cdda://</path>
     <path>cdda://</path>
   </bookmark>
   </source>
</xml>
</pre>
|}
 
 
 
[[Category:Development]]

Latest revision as of 13:43, 18 March 2025

This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions.


There are two main types of sources, Local and Network. In addition, there are specialty sources that are only available in certain sections of Kodi, (such as in Music_library or Video_library).

Sources with multiple paths / targets

It is possible to let a media source point to more than one target or path. You can accomplish this through the User Interface or by directly editing the sources.xml. One example from the Videos section of the default Sources.xml file. 

  <source>
    <name>01 Movies</name>
    <path pathversion="1">F:\Kodi\Movies HD\</path>
    <path pathversion="1">E:\Kodi\Movies SD\Movies New\</path>
  </source>

The pathversion="1" parameter means it was written with a more recent version of Kodi. It's to ensure that saved paths can be reliably updated if/when a new way to store them is implemented (e.g. old paths using Q: are now stored using special://xbmc etc).

You can have multiple paths in local, SMB and NFS sources, not for the other protocols.

Local Sources

Basic Sources

Local sources are ones that point to the local available drives like hard disks, memory cards, optical drive, etc. Kodi can play audio CDs from DVD drives as well as Video-DVD's. Kodi has a built in audio CD ripper. This ripper supports ripping to wav, mp3 and OGG vorbis formats and attempts to name your tracks using data sourced from CDDB.com.

Generic Network Sources

Network sources reference remote shares of various types. Kodi supports SMB (windows file sharing, also known as Samba or CIFS), among others. These generic network sources are supported in all Kodi sections in Kodi ("Music", "Videos", "Pictures", and "Filemanager"). You can also add multiple paths (<path></path>) in each source. See Sharing media from your PC how to configure such servers yourself.

Windows File Sharing (SMB/SAMBA/CIFS)

SMB sharing is the most common and probably the best performing sharing solution for Kodi. It supports domains and workgroups as well.

Note: For much more information about using SMB/SAMBA/CIFS in Kodi, see the File_sharing article.

The full syntax for sharing is as follows: 

  <source>
    <path>smb://domain;username:password@computername_or_ipaddress/sharename/path</path>
  </source>

domain - If you use a domain controller you may enter it here

username - The username used to authenticate with the server

password - The password used to authenticate with the server

computername/ipaddress - As long as a name server is available on the network computer names *should* work. If any connectivity issues are encountered when using computer names replace it with the direct IP address of the computer.

sharename - Share name on the remote server

path - path relative to the share

If any variables are not needed omit the required punctuation.
Examples (where "USER" is the user-name, "12345" is the password, and "192.168.0.200" is the IP-address of the server):

For a direct link to a server use: 

  <source>
    <path>smb://USER:[email protected]</path>
  </source>

For a direct link to a share on a server use: 

  <source>
    <path>smb://USER:[email protected]/share/</path>
  </source>

For a direct link to a subfolder under a share on a server use: 

  <source>
    <path>smb://USER:[email protected]/share/path/</path>
  </source>

For a direct link to all servers in your workgroup/domain use (for this you must have entered your username, password and workgroup/domain in the Kodi GUI first): 

  <source>
    <path>smb://</path>
  </source>

Network Filesystem (NFS)

NFS sharing is the a full alternative to SMB sharing. It allows the the same features by reaching a better performance (due to less protocol overhead). Also there is no need to save any account information (username, password) inside the xml files, because NFS authentication is done via UID of the user running Kodi and the access rights granted for this UID on the NFS exported filesystem.

Note: For much more information about using NFS in Kodi, see the NFS article.

The full syntax for sharing is as follows: 

  <source>
    <path>nfs://ipaddress/exported_path</path>
  </source>

ipaddress - At the moment there is no name resolution possible. Use the direct IP address of the NFS server for now.

exported_path - The absolute path on the NFS server. The exported_path can be the exported path or exported path including subfolders. At least one of the exported paths of the NFS server should be found inside the the exported_path.

For a direct link to a server for getting a list of exported paths do (exchange IP with the one from your NFS server in the example below): 

  <source>
    <path>nfs://192.168.0.200</path>
  </source>

UPnP (Universal Plug and Play)

UPnP (short for "Universal Plug and Play") 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. The UPnP-client in Kodi (also called "UPnP AV Media Server Control Point") supports direct links to the server/shares and auto-discovery of servers available on the local network. UPnP require a UPnP-server (also called "UPnP AV Media Server"), UPnP AV Media Servers is where you store and share your media (pictures/videos/audio/music) from. There are UPnP Media Servers available for most operating-systems and many hardware-platforms, UPnP AV Media Servers can be either be categorized as software-based or hardware-based. Software-based Media Servers can be run on PC (personal-computer), mainly on Windows, Linux, BSD, Unix or Mac platform. And, hardware-based Media Servers may run on any NAS (Network Attached Storage) or any specific hardware for delivering media, like for example a PVR (Personal Video Recorder) device.

For auto-discovery (default in Kodi) use the following share:

  <source>
    <path>upnp://</path>
  </source>

For a direct link to a server use:

  <source>
    <path>upnp://ip_address:1901</path>
  </source>

For a direct link to a specific share on a server use: 

  <source>
    <path>upnp://ip_address:1901/share/</path>
  </source>

For a direct link to a subfolder under a share on a server use: 

  <source>
    <path>upnp://ip_address:1901/share/path/</path>
  </source>

FTP (File Transfer Protocol) Client

Kodi also contains an FTP-client with which you can add sources in all sections in Kodi interface. (Remember that the default FTP-port is usually 21).

Example (if any variables are not needed, omit the required punctuation): 

  <source>
    <!--to connect as anonymous use ftp://ip:port/-->
    <path>ftp://username:password@ipaddress:port/folder/</path>
  </source>

SFTP (SSH File Transfer Protocol) Client

  <source>
    <name>Remote SFTP Videos</name>
    <path>sftp://username:[email protected]/share/videos/</path>
  </source>

HTTP (Hypertext Transfer Protocol ) Client

Kodi also contains an HTTP-client with which you can add sources in all sections in the Kodi interface.

Example (if any variables are not needed, omit the required punctuation): 

  <source>
    <!--to connect as anonymous use "http://ipaddress:port/" or just "http://ipaddress"-->
    <path>http://username:password@ipaddress:port/directory/|option1=value1&option2=value2</path>
  </source>

Examples of options include "auth", which is required if your HTTP server uses any type of authentication other than basic (which is, in fact, unsafe unless used over HTTPS). E.g. if your HTTP server uses digest authentication, use http://username:password@host:port/directory/|auth=digest. For maximum flexibility, use auth=any or auth=anysafe (i.e. anything other than basic).

Other options include:

  • Referrer
  • User-Agent
  • Cookie
  • Encoding

For the meanings of these, see RFC 2616.

RSS Feeds

RSS (which stands for "Really Simple Syndication") is a family of web feed formats used to publish frequently updated works—such as blog entries, news headlines, audio, and video—in a standardized format. An RSS document is commonly called a "RSS feed", "RSS channel", or "Web feed", includes full or summarized text, plus metadata such as publishing dates and authorship. Podcasts is a is a series of audio or video digital-media files which is distributed over the Internet by such RSS feeds, and Video Podcasts are often referred to as "Vidcast" or "Vodcast".

Kodi features a built RSS Feed Reader Client for such audio and video sources, this type of media source will connect to the RSS feed you enter and lists the video or audio available to stream with thumbnails and metadata if available.

Note: Please make sure you have read the RSS Feeds in Kodi Guide. 

  <source>
    <name>RSS Feed</name>
    <path>rss://</path>
  </source>

WebDAV

You can either connect Kodi to a WebDAV-Server via an unencrypted dav (HTTP) or an encrypted davs (HTTPS) connection. If you choose to connect Kodi to your WebDAV server via its IP address instead of its hostname, then you are forced to choose an unencrypted dav (HTTP) connection. This is due to Kodi's WebDAV client implementation, where an encrypted davs (HTTPS) connection is always associated to a vaild SSL certificate which yet is associated to a WebDAV server's host-/domainname. In other words: If you choose to connect via an encrypted davs (HTTPS) connection, you are forced to connect via your WebDAV server's host-/domainname instead of its IP address and you will need a valid SSL certificate securing/validating your davs (HTTPS) connection. Depending on whether you are using a reverse web proxy server or not and on how it is configured, the according SSL certificate mostly has to be installed directly on your WebDAV server. Be aware that self-signed certificates do not work as they will be revoked by the Kodi WebDAV client, you can get a valid SSL certificate provided by an official certificate authority, for example "Let's encrypt".

Example unencrypted dav (HTTP): 

  <source>
    <name>Remote WebDAV videos</name>
    <path>dav://username:[email protected]/share/videos/</path>
  </source>

Example encrypted davs (HTTPS): 

  <source>
    <name>Remote WebDAV videos</name>
    <path>davs://username:[email protected]/share/videos/</path>
  </source>

Plugin Sources

A plugin source is a special type of source that is powered by a python script automatically run by Kodi. A plugin source is typically used to represent the online content of a website as a hierarchical file system.

Kodi supports 3 types of plugin sources: video, music, and pictures. Plugins are placed in the "plugins\<type of media>" folder within the Kodi folder.

Plugin sources can be added from within Kodi through the Addon Manager, accessible from the "Settings" menu option on the home screen.

The actual file that is invoked by Kodi is "plugins\<type of media>\<name of plugin>\default.py". This file must be present for the plugin to show up in "Add Source" the dialog.

Videos Specific Sources

Video Library

This special source allows you to access the video database without switching to library view. This is useful for remote browsing of the video library, i.e. via the web interface. 

  <source>
    <name>Library</name>
    <path>videodb://</path>
  </source>

HDHomeRun

This type of media source will connect to a HDHomeRun (Networked Digital Cable TV/HDTV Tuner) box and allows you to watch Live TV directly from Kodi.

  <source>
    <name>HDHomeRun</name>
    <path>hdhomerun://</path>
  </source>

Music Specific Sources

Music Library

This special source allows you to access the music database without switching to Music Library view. This is useful for remote browsing of the music library, i.e. via the web interface. 

  <source>
    <name>Library</name>
    <path>musicdb://</path>
  </source>

Forced CDDA

Kodi employs auto-detection of the type of CD or DVD disks in the drive. If for some reason you wish to have a share that forces Kodi to read the disk as an CDDA AudioCD (Compact Disk Digital Audio) use the following share. 

  <source>  
    <name>CDDA</name>
    <path>cdda://</path>
  </source>
Retrieved from "https://kodi.wiki/index.php?title=Sources.xml/Types&oldid=255063"