Path substitution: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Robot: Substituting template: Name)
m (Robot: Changing Category:XBMC Manual to Category:Manual)
Line 39: Line 39:
* [[HOW-TO:Sync multiple libraries/Sync other parts of XBMC]]
* [[HOW-TO:Sync multiple libraries/Sync other parts of XBMC]]
* [[Special protocol]]
* [[Special protocol]]
{{frodo updated}}


[[Category:Settings]]
[[Category:Settings]]
[[Category:XBMC Manual]]
[[Category:Manual]]
[[Category:Advanced topics]]
[[Category:Advanced topics]]
{{frodo updated}}

Revision as of 21:37, 17 November 2014

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 some of the special protocol.

Examples

Save as "advancedsettings.xml" in your userdata folder:

Example 1 - changing the path of music files
<advancedsettings>
 <pathsubstitution>
  <substitute>
    <from>SMB://192.168.1.19/Music/</from>
    <to>G:\Music\</to>
  </substitute>
 </pathsubstitution>
</advancedsettings>


Example 2 - changing where thumbnails are stored

Note: This will slowdown thumbnail loading, but might be worth it for low-memory devices such as the ATV2.

<advancedsettings>
 <pathsubstitution>
  <substitute>
    <from>special://profile/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