Archive:Migration from XBMC to Kodi: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 3: Line 3:
<section begin="intro" />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. <section end="intro" />
<section begin="intro" />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. <section end="intro" />


=Before you start=
== Before you start ==
==Don't uninstall XBMC==
=== 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 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.
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==
=== Back up ===
{{main|Backing up}}
{{main|Backing 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.
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.
Line 15: Line 15:
{{editor note|A step-by-step how-to for the backup add-on will go here with a link to manual file copy instructions}}
{{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=
== Upgrading to Kodi ==
== Windows ==
=== Windows ===
Windows devices use an installer, and this installer will move your files to the new kodi settings folder.
Windows devices use an installer, and this installer will move your files to the new kodi settings folder.


Line 34: Line 34:
portable data folder is not touched at all
portable data folder is not touched at all


=Cleaning up=
== Cleaning up ==


=Other notes=
== Other notes ==
==Webserver and smartphone apps==
=== Webserver and smartphone apps ===
The default username for the [[web server]] has changed from "<code>xbmc</code>" to "<code>kodi</code>". 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|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.  
The default username for the [[web server]] has changed from "<code>xbmc</code>" to "<code>kodi</code>". 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|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.  


{{helix updated}}
{{helix updated}}
[[Category:Manual]]
[[Category:Manual]]

Revision as of 06:04, 22 December 2014

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.