Path substitution: Difference between revisions
(Revert to earlier version. Warning does not seem accurate) |
|||
| Line 4: | Line 4: | ||
== Special notes about path substitution for userdata files == | == Special notes about path substitution for userdata files == | ||
{{divbox|orange||<big>'''Note:''' This is considered an advanced (complicated) | {{divbox|orange||<big>'''Note:''' This is considered an advanced (complicated) feature.</big><br /><br />Path substitution is not officially supported for settings files. It probably won't hurt anything, but some things might not always work right depending on what you are substituting.<br /><br /> | ||
;<big>Thumbnails</big> | ;<big>Thumbnails</big> | ||
Sharing the Thumbnails folder with Path Substitution is prone to problems, primarily because the Texture Cache consists of two interlinked data stores - the Thumbnails folder and the SQLite database Textures13.db. Sharing the SQLite Textures13.db between multiple clients is <strong>not</strong> supported under any circumstances due to the liklehood of database corruption.<br /><br /> | Sharing the Thumbnails folder with Path Substitution is prone to problems, primarily because the Texture Cache consists of two interlinked data stores - the Thumbnails folder and the SQLite database Textures13.db. Sharing the SQLite Textures13.db between multiple clients is <strong>not</strong> supported under any circumstances due to the liklehood of database corruption.<br /><br /> | ||
Revision as of 04:03, 25 December 2015
|
 advancedsettings.xml |
Path substitution
|
Path substitutions are settings in advancedsettings.xml to force Kodi 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 Kodi to handle. Path subs work for most file and folder paths. Path subs work across local and network paths, across different network protocols, and can even be used with some of the special protocol.
Special notes about path substitution for userdata files
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. See also HOW-TO:Reduce disk space usage.
<advancedsettings>
<pathsubstitution>
<substitute>
<from>special://profile/Thumbnails/</from>
<to>PROTOCOL://YOUR_NETWORK_SHARE/Kodi/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