Path substitution: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>Jmarshall
No edit summary
>Jmarshall
No edit summary
Line 1: Line 1:
'''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]]**. Files (requires Eden RC1 or later) or folders can be substituted.
'''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). Files (requires Eden RC1 or later) or folders can be substituted.


==Examples==
==Examples==
Line 24: Line 24:
</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.
==See also==
==See also==
*[[advancedsettings.xml#<pathsubstitution>]]
*[[advancedsettings.xml#<pathsubstitution>]]

Revision as of 19:22, 27 February 2012

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). Files (requires Eden RC1 or later) or folders can be substituted.

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.

See also