Adding Media Sources


 * XBMC can link to various sources for data. For more information on the types of sources look at Advanced Topics/Types of Media Sources.

Through the User Interface

 * By default every root section includes a Add Sources button that you can click to start adding sources. This can be disabled though Settings/Appearance/View Options/Disable add source buttons in file lists.

Through Sources.xml

 * Note: This is considered to be an Advanced Topic, most settings can be changed in the GUI, see previous paragraph.


 * sources.xml is the configuration file where XBMC stores your media source locations. In this section we will concentrate on xml syntax of sources and the various options that are available.


 * The configuration file sources.xml exists in the userdata folder. It depends on your Operating System (Linux, Mac, XP, Vista) and if you changed the default settings during installation, where you can find your userdata folder. See Advanced Topics/The UserData Folder to find out where you have to look.


 * XML Syntax and Source Breakdown
 * XML syntax is very similar to html syntax, but can be less forgiving. Lets first take a look at a source:


 * Some basics to cover first:


 * Tags : Each word inside of <> symbols is called a 'tag'. Tags can either be starting, or ending tags. To make an ending tag you simply add a forward slash / to the beginning of the tag name. is a starting tag is an ending tag. Developers try to make tag names as self explanatory as possible. for example is the name of the source.


 * Data : Between two tags is where any data associated with that source is stored. DATA . You can also store other tags inside of each other


 * Example:


 * Required Fields
 * This tag defines which section your source belongs to. Other valid sections are  and . You cannot have multiple sections in your xml file.
 * This tag defines which section your source belongs to. Other valid sections are  and . You cannot have multiple sections in your xml file.


 * If you specify the Name of a source here, the contents of this source will be shown when you enter e.g. the Music section (this example) instead of the ROOT shares listing.
 * If you specify the Name of a source here, the contents of this source will be shown when you enter e.g. the Music section (this example) instead of the ROOT shares listing.


 * The Name of the source. This will accept any characters in the current character set.
 * The Name of the source. This will accept any characters in the current character set.


 * The path of the source. This can be a local path such as "e:\media\images\" or remote url such as "smb://username:password@serverip/path/". You may have more than one tag in a single source, called multipaths. in Multipaths the directory listings will be combined. See Types of Media Sources for more information concerning paths.
 * * Multipath sources are restricted to local (PC or Xbox built-in hard drive), smb/samba, and xbms paths.
 * * The path can not be a playable object or an executable file, (ie a video, audio or .xbe file), it must be a share or a sub folder under a share.
 * * The path can not be a playable object or an executable file, (ie a video, audio or .xbe file), it must be a share or a sub folder under a share.


 * Multipath Example:


 * Thumbnails

Locking

 * If you want to make a source more private, you can use lockcodes or passwords to protect that source. The easiest way to accomplish this in XBMC, is using the GUI dialogs. First, enable the Master Lock in Settings/System/Master Lock. After enabling the Master Lock, a Set Lock button will pop up in the Context Menu allowing you to set a lock. XBMC will ask for the master lock code and than give you the opportunity to set a unique Password on that specific share. To Remove the Lock you need to remember the Master Lock code.


 * Note: Locking a source means you only give it protection in XBMC. Outside XBMC the source is still available and only protected, or not protected at all, by the Operating System. In the same way, if someone has access to manually edit the sources.xml he or she can remove or change the settings for the locked source. So, don't feel too safe when you protect a source in XBMC.


 * Note: The advanced user again, can manually edit the sources.xml file to accomplish the same. Remember when you enter lockcodes in the configuration file sources.xml you must first convert the lockcode to MD5 hash format before you enter them. You can use this site (link) to convert/hash them.


 * Note: The rest of this paragraph is for the advanced user.


 * Locking Example:


 *  and 
 * consists of four options:
 * 0
 * Source is not locked. This is the default value if not specified.
 * 1
 * Numeric lock. Can be typed via on screen numpad or remote control. Must be a numberic value.
 * 2
 * Gamepad lock. Enter by pushing Xbox controller button sequence.
 * Enter gamepad button sequence using the following letter codes:
 * A B X Y = Same as buttons on gamepad
 * U D L R = D-pad Up, Down, Left, Right
 * W K = White, Black, Left Trigger, Right Trigger
 * 3
 * Full-text lock. Enter with on screen keyboard or USB keyboard.
 * Enter HTML-escaped alphanumeric password. Make sure all characters are available on your language's on screen keyboard/USB keyboard.