HOW-TO:Change data location for Android: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Credit goes to technisol from forum.kodi.tv - http://forum.kodi.tv/showthread.php?tid=229396&pid=2040300#pid2040300)
Line 2: Line 2:
<section begin="intro" />As of v14, Kodi supports a backdoor to specify the location of your settings folder, which includes the [[userdata folder]] and add-ons. It is the equivalent of using environment variables on other platforms<section end="intro" />
<section begin="intro" />As of v14, Kodi supports a backdoor to specify the location of your settings folder, which includes the [[userdata folder]] and add-ons. It is the equivalent of using environment variables on other platforms<section end="intro" />


 
This is accomplished by creating a plain text file file at <code>/sdcard/xbmc_env.properties</code> (the root directory for the Android device) with the following line:
To do so, create a file <code>/sdcard/xbmc_env.properties</code>.
Its content is simply:
 


<syntaxhighlight lang="text">
<syntaxhighlight lang="text">
Line 11: Line 8:
</syntaxhighlight>
</syntaxhighlight>


'''''Example:''''' <code>xbmc.data=/storage/sdcard0/external_sdcard/kodi_data</code>
== How-to ==
{{how-to
| Step1= Quit Kodi by using the quit option or shutdown menu from within Kodi.
 
| Step2= In the root directory of the internal storage of your device, usually just mnt/sdcard (not mnt/sdcard/root) create a plain text file called: '''<code>xbmc_env.properties</code>'''
 
{{note|You must use "xbmc" when noted above for the text and file name, even when using Kodi.}}
 
| Step3 = In '''<code>xbmc_env.properties</code>''' you need to tell Kodi where it's data will now be stored.
 
This will be done by creating a path statement like:
 
:<syntaxhighlight lang="text">xbmc.data=/storage/sdcard0/external_sdcard/kodi_data</syntaxhighlight>
 
 
The path might start with /storage/ as shown above, but it might be different on various Android devices. You can find the correct path by using a file explorer, like "File Browser" or "Root Explorer" to determine the proper path.
 
 
For example:
:A USB drive location might look like: <syntaxhighlight lang="text">xbmc.data=/storage/external_storage/sda1/kodi_data/</syntaxhighlight>
 
| Step4 = Using a file manager program, such as "File Browser" or "Root Explorer", move or copy the '''<code>.kodi</code>''' directory from <code>/sdcard/Android/data/org.xbmc.kodi/.kodi</code> to the new location you defined in '''Step 3'''.
 


For example:


{{note|You must use "xbmc" when noted above for the text and file name, even when using Kodi v14.}}
:Move or copy: <code>/mnt/sdcard/Android/data/org.xbmc.kodi/.kodi</code>
{{note|The destination folder must be created manually beforehand (This is not a limitation. Presence of the folder is used to find out if Kodi has to wait for an external drive to be active)}}


:To: <code>/storage/sdcard0/external_sdcard/kodi_data/</code>


Inside this, a directory ".kodi" will be created which contain the well-known xbmc structure ("addons", "userdata", ...).
}}


== Notes ==


Currently, the specified path must be an android file path and not a typical network path. i.e. no "smb://" or "nfs://". To use a network file path you must first mount the file share in Android, and then point to that mount path.
The specified path must be a local Android file path and not a typical network path. i.e. no "smb://" or "nfs://". To use a network file path you would need to mount the network share as a local mount, which might require root access on some Android devices.


{{helix updated}}
{{Isengard updated}}


[[Category:Advanced topics]]
[[Category:Advanced topics]]

Revision as of 20:42, 28 June 2015

Home icon grey.png   ▶ Android
▶ Advanced topics		 ▶ HOW-TO:Change data location for Android

As of v14, Kodi supports a backdoor to specify the location of your settings folder, which includes the userdata folder and add-ons. It is the equivalent of using environment variables on other platforms

This is accomplished by creating a plain text file file at /sdcard/xbmc_env.properties (the root directory for the Android device) with the following line: 

xbmc.data=<path to the Kodi data folder you wish to use>

How-to

1 Quit Kodi by using the quit option or shutdown menu from within Kodi.
2 In the root directory of the internal storage of your device, usually just mnt/sdcard (not mnt/sdcard/root) create a plain text file called: xbmc_env.properties

Note: You must use "xbmc" when noted above for the text and file name, even when using Kodi.

3 In xbmc_env.properties you need to tell Kodi where it's data will now be stored.

This will be done by creating a path statement like: 

xbmc.data=/storage/sdcard0/external_sdcard/kodi_data


The path might start with /storage/ as shown above, but it might be different on various Android devices. You can find the correct path by using a file explorer, like "File Browser" or "Root Explorer" to determine the proper path.


For example:

A USB drive location might look like: 
xbmc.data=/storage/external_storage/sda1/kodi_data/
4 Using a file manager program, such as "File Browser" or "Root Explorer", move or copy the .kodi directory from /sdcard/Android/data/org.xbmc.kodi/.kodi to the new location you defined in Step 3.


For example:

Move or copy: /mnt/sdcard/Android/data/org.xbmc.kodi/.kodi
To: /storage/sdcard0/external_sdcard/kodi_data/


Notes

The specified path must be a local Android file path and not a typical network path. i.e. no "smb://" or "nfs://". To use a network file path you would need to mount the network share as a local mount, which might require root access on some Android devices.

Retrieved from "https://kodi.wiki/index.php?title=HOW-TO:Change_data_location_for_Android&oldid=98177"