Archive:Migration from XBMC to Kodi

From Official Kodi Wiki
Revision as of 06:04, 22 December 2014 by Ned Scott (talk | contribs)
Jump to navigation Jump to search

Template:Helix

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.

Before you start

Don't uninstall XBMC

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

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.

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.

Editor note: A step-by-step how-to for the backup add-on will go here with a link to manual file copy instructions

Upgrading to Kodi

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.

portable data folder is not touched at all

Cleaning up

Other notes

Webserver and smartphone apps

The default username for the web server 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.