21 Aug 2020 - The wiki is undergoing a major cleanup. If you arrived here from a search engine and cannot find the page, please use the wiki search instead (top right corner of page)
More info can be found on the forum

Migration from XBMC to Kodi

From Official Kodi Wiki
Jump to: navigation, search

As of version 14, XBMC has been renamed to Kodi. Because of this, installing Kodi v14 on a device that has an old XBMC install will cause some changes.

1 Before you start

1.1 Don't uninstall XBMC

For Android devices, you must not uninstall XBMC before installing Kodi. Doing so will erase all your settings and libraries.

For all other devices, don't uninstall XBMC just yet. While your settings won't go away, we will need the older version in order to backup your files first.

1.2 Back up

While not required, it is strongly recommended that all users backup their older XBMC settings before upgrading to Kodi. This is required if you desire to go back to XBMC v13, and backing up before an upgrade is generally a good idea for the off chance something goes wrong.

1.3 MySQL


Users who use MySQL library sharing do not need to do anything special for Kodi. As always, it is still a good idea to backup your MySQL databases anyways. If this is the first time you are upgrading any version of XBMC to another, then you will still want to review MySQL/Upgrading to make sure your MySQL server is set up correctly.

If you use "xbmc" as a username or password in your advancedsettings.xml file, you do not need to change it. In fact, it's probably easiest to just leave your advancedsettings.xml file just the way it is. The MySQL server doesn't know or care that the program's name has changed from XBMC to Kodi.

2 Upgrading to Kodi

Stop hand.png If updating from v10, v11, v12: Don't update from v12 or earlier to v15 or higher in one step. You will need to update with a version in between, such as v13 or v14. In other words, download the older version v14, wait for everything to update, and then update to v15 or higher.

For most users, this process is exactly the same as installing any other older version of XBMC. Simply download Kodi from


and follow the normal Installing instructions.

Special notes are detailed below in the sub-sections, if they apply:

2.1 Android

If you are using a modified or forked version of XBMC (such as SPMC, XBMC on OUYA, MiniX Edition, etc) then Kodi will not migrate those settings, as they use a different Android app ID. You can manually copy the settings over using a file manager app, or use the Backup add-on.

2.2 Windows

Windows devices use an installer, and this installer will move your files to the new kodi settings folder.

If User installs into a dir were kodi is already installed ask if he wants to overwrite it.

  • a. if user says “yes” – un-install former installation and install new
  • b. if user says “no” – he stays at the folder selection page and can re-decide

If user installs into a different directory

  • a. He said no on 1.b – kodi will just be installed in the different directory
  • b. He selected the new directory initally without hitting the question in 1. – check if there is a kodi installation in another directory – if so – ask user if he wants us to un-install it. If no – kodi will be installed side by side

At the end of installation check for an old XBMC installation

  • a. if found – ask if the user wants us to un-install it
  • a1 if user said “yes” – un-install old XBMC installation and move the userdata – inform the user about the moved data
  • a2 if user said “no” – keep the old XBMC installation and DON’T move the userdata – inform the user about the fact that kodi will use the default profile data.

If you use "Portable mode" then the portable data folder is not touched at all

3 Cleaning up

Once Kodi v14 is installed then the older XBMC version can be uninstalled safely. You might wish to first open Kodi v14 to confirm your older settings were transferred just to be safe.

Use the Android settings app, select "Apps", select "XBMC", then to uninstall XBMC.
iDevice users can uninstall XBMC using Cydia. ATV2 users can use the following command for help with the ATV2 command line)
apt-get remove org.xbmc.xbmc-atv2
Mac OS X
Drag the XBMC.app icon from the Applications folder into the Trash can.
XBMC should automatically be uninstalled when upgrading to Kodi.
If you did not opt to remove the old XBMC install with the Kodi installer, then you can remove XBMC under the "Programs" Control Panel.

4 Other notes

4.1 Webserver and smartphone apps

The default username for the Webserver has changed from "xbmc" to "kodi". This might also affect some smartphone/tablet remotes that use the webserver for extra data. You can either change the default back to "xbmc" in Settings (Settings -> Services -> Webserver) or change the username on your smartphone/tablet app to "kodi". Users who have changed their default usernames should not be affected.