Difference between revisions of "Path substitution"

From Official Kodi Wiki
Jump to: navigation, search
m (Robot: Cosmetic changes)
Line 1: Line 1:
{{divbox|orange||<big>'''Note:''' This is considered an advanced (complicated) and experimental feature.</big><br/><br/>Path substitution is not officially supported for settings files with the exception of playlists. It probably won't hurt anything, but some things might not always work right depending on what you are substituting.}}
+
{{divbox|orange||<big>'''Note:''' This is considered an advanced (complicated) and experimental feature.</big><br /><br />Path substitution is not officially supported for settings files with the exception of playlists. It probably won't hurt anything, but some things might not always work right depending on what you are substituting.}}
 
'''Path substitutions''' are settings in [[advancedsettings.xml#<pathsubstitution>|advancedsettings.xml]] to force XBMC to use different file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for XBMC to handle. Starting in XBMC v11 (Eden) path subs works for most file paths. Path subs work across local and network paths, across different network protocols, and can even be used with the [[special protocol]] (see note below).
 
'''Path substitutions''' are settings in [[advancedsettings.xml#<pathsubstitution>|advancedsettings.xml]] to force XBMC to use different file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for XBMC to handle. Starting in XBMC v11 (Eden) path subs works for most file paths. Path subs work across local and network paths, across different network protocols, and can even be used with the [[special protocol]] (see note below).
  
==Examples==
+
== Examples ==
 
<pre>
 
<pre>
 
<advancedsettings>
 
<advancedsettings>
Line 25: Line 25:
 
</pre>
 
</pre>
  
NOTE: Not all special paths can be substituted. In particular, special://musicplaylists/ and special://videoplaylists/ should not be substituted, as internally these are multipaths that cannot be written to (thus saving of playlists will go elsewhere). Instead, one should use the advanced setting <system><playlistpath> to change this.
+
NOTE: Not all special paths can be substituted. In particular, special://musicplaylists/ and special://videoplaylists/ should not be substituted, as internally these are multipaths that cannot be written to (thus saving of playlists will go elsewhere). Instead, one should use the advanced setting <system><playlistpath> to change this.
  
'''Windows does not support smb:// paths, use UNC paths instead.''' UNC paths in Windows (\\server\share) will not allow the use of a specific XBMC username and password like smb://username:[email protected]/share would.
+
'''Windows does not support smb:// paths, use UNC paths instead.''' UNC paths in Windows (\\server\share) will not allow the use of a specific XBMC username and password like smb://username:[email protected]/share would.
==See also==
+
== See also ==
*[[advancedsettings.xml#<pathsubstitution>]]
+
* [[advancedsettings.xml#<pathsubstitution>]]
*[[HOW-TO:Sync multiple libraries/Sync thumbails and fanart]]
+
* [[HOW-TO:Sync multiple libraries/Sync thumbails and fanart]]
*[[HOW-TO:Sync multiple libraries/Sync other parts of XBMC]]
+
* [[HOW-TO:Sync multiple libraries/Sync other parts of XBMC]]
*[[Special protocol]]
+
* [[Special protocol]]
  
 
[[Category:Settings]]
 
[[Category:Settings]]

Revision as of 15:31, 27 April 2013

Path substitutions are settings in advancedsettings.xml to force XBMC to use different file paths. These are processed in order, and are useful for substituting an absolute path on a PC with a path suitable for XBMC to handle. Starting in XBMC v11 (Eden) path subs works for most file paths. Path subs work across local and network paths, across different network protocols, and can even be used with the special protocol (see note below).

1 Examples

<advancedsettings>
 <pathsubstitution>
  <substitute>
    <from>SMB://192.168.1.19/Music/</from>
    <to>G:\Music\</to>
  </substitute>
 </pathsubstitution>
</advancedsettings>
<advancedsettings>
 <pathsubstitution>
  <substitute>
    <from>special://masterprofile/Thumbnails/</from>
    <to>PROTOCOL://YOUR_NETWORK_SHARE/xbmc/userdata/Thumbnails/</to>
  </substitute>
 </pathsubstitution>
</advancedsettings>

NOTE: Not all special paths can be substituted. In particular, special://musicplaylists/ and special://videoplaylists/ should not be substituted, as internally these are multipaths that cannot be written to (thus saving of playlists will go elsewhere). Instead, one should use the advanced setting <system><playlistpath> to change this.

Windows does not support smb:// paths, use UNC paths instead. UNC paths in Windows (\\server\share) will not allow the use of a specific XBMC username and password like smb://username:[email protected]/share would.

2 See also