Sources.xml/Types

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 in My Music or My Videos). Only local bookmarks are supported under My Programs, (you can not stream Xbox games or other executables of the network). You can also add multiple paths (<path></path>) in each bookmark.

Local Bookmarks

Basic Bookmarks

Local bookmarks are ones that reference the local Xbox harddisk drive, DVD--ROM drive or memory cards. C D E F G are all valid local Xbox drives to access, (D being the DVD-ROM drive, C and E being the default C: and E: partitions, and F and G being the extended F: and G: partitions that you get when you replace your Xbox harddrive with a larger one). 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). X Y Z are Xbox default cache partitions and should not need to be referenced for any reason.

<xml> <bookmark> <name>E Drive</name> <path>E:\Media\Movies\</path> <path>F:\Media\Movies\</path> </bookmark> <bookmark> <name>DVD-ROM Drive</name> <path>D:\</path> </bookmark> </xml>

Advanced Special Bookmarks

XBMC has the option to force the DVD drive to read the disk as a iso9660 or UDF filesystem.
If you have the need for these functions simply use the following bookmarks:

<xml>
 <bookmark>
   <name>ISO</name>
   <path>iso9660://</path>
 </bookmark>

 <bookmark>
   <name>UDF</name>
   <path>UDF://</path>
 </bookmark>
</xml>

Generic Network Bookmarks

Network bookmarks reference remote shares of various types. XBMC supports SMB (windows file sharing), XBMS (also known as CCX), among others. These generic network bookmarks are supported in all XBMC sections in XBMC ("My Music", "My Videos", "My Pictures", and "File-Manager"), with the exception of "My Programs" (where only local bookmarks are supported). You can also add multiple paths (<path></path>) in each bookmark.

Windows File Sharing (SMB/SAMBA/CIFS)

SMB sharing is the most common and probebely the best performing sharing solution for XBMC. It supports domains and workgroups as well. The full syntax for sharing is as follows:

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

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 "xbox" 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:

<xml>
 <bookmark>
   <path>xbox:12345@smb://192.168.0.200</path>
 </bookmark>
</xml>

For a direct link to share on a server use:

<xml>
 <bookmark>
   <path>smb://xbox:[email protected]/share/</path>
 </bookmark>
</xml>

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

<xml>
 <bookmark>
   <path>smb://xbox:[email protected]/share/path/</path>
 </bookmark>
</xml>

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 XBMC GUI first):

<xml>
 <bookmark>
   <path>smb://</path>
 </bookmark>
</xml>

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

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

<xml>
 <bookmark>
   <path>upnp://</path>
 </bookmark>
</xml>

For a direct link to a server use:

<xml>
 <bookmark>
   <path>upnp://ip_address:1901</path>
 </bookmark>
</xml>

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

<xml>
 <bookmark>
   <path>upnp://ip_address:1901/share/</path>
 </bookmark>
</xml>

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

<xml>
 <bookmark>
   <path>upnp://ip_address:1901/share/path/</path>
 </bookmark>
</xml>

XBMS Protocol (CCX/ccXStream)

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 Configuring XBMS Shares.

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

<xml>
 <bookmark>
   <path>xbms://</path>
 </bookmark>
</xml>

For a direct link to a server use:

<xml>
 <bookmark>
   <path>xbms://ip_address:1400</path>
 </bookmark>
</xml>

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

<xml>
 <bookmark>
   <path>xbms://ip_address:1400/share/</path>
 </bookmark>
</xml>

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

<xml>
 <bookmark>
   <path>xbms://ip_address:1400/share/path/</path>
 </bookmark>
</xml>

FTP (File Transfer Protocol) Client

XBMC does also cotain a FTP-client with which you can add booksmarks in all sections (except for My Program), however as FTP (File Transfer Protocol) is not designed to stream audio/video data it is not recommended that you use it under the My Music nor in the My Videos sections, trying to stream audio or video via FTP does not go good. (Rememeber that the default FTP-port is usually 21).

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

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

My Videos-Specific Bookmarks

ReplayTV sharing

ReplayTV is a stand-alone PVR/DVR (Personal Video Recoder/Digital Video Recoder) box, (a rival to 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).

For auto-discovery (default in XBMC) use the following share in the video section:

<xml>
 <bookmark>
   <path>rtv://*/</path>
 </bookmark>
</xml>

My Music-Specific Bookmarks

Microsoft Soundtracks

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>

iTunes Network Share (DAAP)

iTunes contains a method of sharing its database. XBMC can play all unprotected files, (ie. all files not purchased on iTunes Music Store, which can not be be played in XBMC because they are encrypted with Apple's proprietary DRM, proprietary). 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 Configuring Itunes Shares <xml>

 <bookmark>
   <name>iTunes Network Share (DAAP)</name>
   <!-- Only use an IP-address here!-->
   <path>daap://192.168.1.100</path>
 </bookmark>

</xml>

.

Shoutcast Streams

This type of bookmark will contact www.shoutcast.com and list the webradio streams provided by them. This bookmark is available in My Music by default.

<xml> <bookmark>

 <name>SHOUTcast - Directory</name>
 <path>shout://www.shoutcast.com/sbin/newxml.phtml</path>

</bookmark> </xml>

Forced CDDA

XBMC 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 the Xbox to read the disk as an CDDA AudioCD (Compact Disk Digital Audio) use the following share. <xml>

 <bookmark>  
   <name>CDDA</name>
   <path>cdda://</path>
 </bookmark>

</xml>