Archive:Kodi v14 (Helix) FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
mNo edit summary
 
(32 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{mininav| [[FAQs]] {{l2| [[Devices]] }} }}


{{XBMC FAQ}}


<section begin="intro" />Frequently Asked Questions for upgrading to Kodi v14 (codename Helix) from a previous version. Includes how to enable some of the new features, where some controls got moved to, etc.<section end="intro" />
<section begin="intro" />Frequently Asked Questions for upgrading to Kodi v14 (codename Helix) from a previous version. Includes how to enable some of the new features, where some controls got moved to, etc.<section end="intro" />
Line 8: Line 6:
{{-}}
{{-}}
== General FAQ ==
== General FAQ ==
:{{big|''See also: '''[[All platforms FAQ]]''' for an FAQ that applies to all versions of Kodi.''}}
:{{big|''See also: '''All platforms FAQ''' for an FAQ that applies to all versions of Kodi.''}}


=== What is Kodi? What is Helix? ===
=== What is Kodi? What is Helix? ===
{{Main|Kodi name change FAQ|History of XBMC}}
Kodi is the new name for XBMC media center. "Helix" is the codename for version 14, just as "Gotham" was the codename for XBMC v13.  You will often see "v14" and "Helix" used interchangeably in the community. It might be a little confusing with so many new names being used, but this is simply the new version of XBMC. As long as you call it version 14/v14/Helix, then everyone will know what you are talking about.
Kodi is the new name for XBMC media center. "Helix" is the codename for version 14, just as "Gotham" was the codename for XBMC v13.  You will often see "v14" and "Helix" used interchangeably in the community. It might be a little confusing with so many new names being used, but this is simply the new version of XBMC. As long as you call it version 14/v14/Helix, then everyone will know what you are talking about.


* Kodi v14.0 "Helix" was released on December 23rd, 2014.
 
* Kodi v14.0 "Helix" was released on [http://kodi.tv/kodi-14-0-helix-unwinds/ December 23rd, 2014].
 
* Kodi v14.1 "Helix", a bugfix update, was released on [http://kodi.tv/kodi-14-1-helix-bugfix-release/ February 1st, 2015].
 
* Kodi v14.2 "Helix", a bugfix update, was released on [http://kodi.tv/kodi-14-2-helix-the-final-translation/ March 28th, 2015].
 


You can download Kodi v14 "Helix" by going to http://kodi.tv/download/
You can download Kodi v14 "Helix" by going to http://kodi.tv/download/


=== Changelog ===
=== Changelog ===
:See: '''[[Kodi v14 (Helix) changelog]]''' (and add-on developers should also see '''[[Helix API changes]]''')
:See: '''Kodi v14 (Helix) changelog''' (and add-on developers should also see '''Helix API changes''')


=== What are some of the major new features? ===
=== What are some of the major new features? ===
::''See '''[[Kodi v14 (Helix) changelog]]''' for a condensed list of large and important changes''
:Examples include:
:Examples include:
* Different selectable keyboard layouts for the '''[[on screen keyboard]]'''.
* Different selectable keyboard layouts for the '''on screen keyboard'''.
* faster library scraping
* faster library scraping
* updated ffmpeg including things like h.265 support
* updated ffmpeg including things like h.265 support
* software decoding defaults to multithread decoding
* software decoding defaults to multithread decoding
* more control over add-ons and their updates in the '''[[add-on manager]]'''
* more control over add-ons and their updates in the '''add-on manager'''
* "big font" size in '''[[Confluence]]'''
* "big font" size in '''Confluence'''
* Freescale i.MX6 support
* Freescale i.MX6 support
* ATSC sub channels for '''[[PVR]]''' in the US
* ATSC sub channels for '''PVR''' in the US
* '''[[PVR]]''' window changes for easier navigation and new EPG views (now/next/channel)
* '''PVR''' window changes for easier navigation and new EPG views (now/next/channel)
* Archives (zip, bin, etc) files can be directly browsed
* Archives (zip, bin, etc) files can be directly browsed


== Upgrading ==
== Upgrading ==
=== How do I upgrade to v14? ===
=== How do I upgrade to v14? ===
{{Main|Migration from XBMC to Kodi}}
{{Main|Archive:Migration from XBMC to Kodi}}


{{Note|Always '''[[backup]]''' your settings before upgrading, just incase!}}
{{Note|Always '''[[backup]]''' your settings before upgrading, just incase!}}
Line 47: Line 49:
* After you install Kodi v14, you can then uninstall your old XBMC v13 install. XBMC v13 must be manually uninstalled in most cases since the upgrade has a new application name, depending on your OS.
* After you install Kodi v14, you can then uninstall your old XBMC v13 install. XBMC v13 must be manually uninstalled in most cases since the upgrade has a new application name, depending on your OS.


{{big|See '''[[Migration from XBMC to Kodi]]''' for full details.}}
{{big|See '''[[Archive:Migration from XBMC to Kodi]]''' for full details.}}


=== PVR add-ons for Ubuntu ===
=== PVR add-ons for Ubuntu ===
* '''[[PVR]]''' add-ons for Ubuntu need to be reinstalled as they will have new Kodi- names.
* '''PVR''' add-ons for Ubuntu need to be reinstalled as they will have new Kodi- names.


=== MySQL ===
=== MySQL ===
{{main|MySQL/Upgrading}}
{{main|MySQL/Upgrading}}
{{Kodi MySQL}}
* As long as your MySQL server is set up to allow XBMC/Kodi to make new databases for the upgrade itself (see '''[[MySQL/Upgrading]]''') then you don't need to do anything for upgrading a MySQL set up for Kodi. Even if you use "XBMC" in your advancedsettings.xml file, you can leave this the same and everything will still work.
* As long as your MySQL server is set up to allow XBMC/Kodi to make new databases for the upgrade itself (see '''[[MySQL/Upgrading]]''') then you don't need to do anything for upgrading a MySQL set up for Kodi. Even if you use "XBMC" in your advancedsettings.xml file, you can leave this the same and everything will still work.
=== What happens if I don't like Kodi v14, can I just install XBMC v13 again? ===
{{Main|Migration}}
:You must restore a backup of your userdata and add-ons, as the v14 upgrade will physically move the location of those files.


==Where did it this or that go?==
==Where did it this or that go?==
=== Play button on remote no longer pauses ===
=== Play button on remote no longer pauses ===
* Custom '''[[keymap]]s''' might need to be adjusted to use the [[action ID]] <code>'''playpause'''</code> instead of <code>play</code>. "Play" alone has new behavior to only play and not pause. This can be done with a basic text editor and going into your [[userdata folder]] and into the '''keymaps''' folder.
* Custom '''[[keymap]]s''' might need to be adjusted to use the [[Action_IDs|action ID]] <code>'''playpause'''</code> instead of <code>play</code>. "Play" alone has new behavior to only play and not pause. This can be done with a basic text editor and going into your [[Userdata|userdata folder]] and into the '''keymaps''' folder.
* Ubuntu users might have to "unmap" media key shortcuts in Ubuntu's keyboard settings, as they are intercepting media keys before they reach Kodi.
 
=== On-screen-keyboard is missing ===
* [[Skins]] that have not been updated to v14 might not have working on-screen-keyboards. You can switch back to the default skin, Confluence, in order to enter text, or wait for an update for your skin to be completely compatible with v14.


=== Live TV ===
=== Live TV ===
* The '''[[PVR|Live TV]]''' home menu option has been renamed to just '''TV'''.
* The '''[[PVR|Live TV]]''' home menu option has been renamed to just '''TV'''.
* Some '''[[Keymap]]''' [[window IDs]] for PVR have changed and will need to be adjusted accordingly.


=== Audio encoder options ===
=== Audio encoder options ===
{{main|Ripping CDs}}
For Ubuntu users (and possibly other linux-based OSes), audio encoders are now binary [[add-ons]] and must be installed through apt-get.  
For Ubuntu users (and possibly other linux-based OSes), audio encoders are now binary [[add-ons]] and must be installed through apt-get. See '''[[Ripping CDs#Adding audio encoders for Ubuntu]]''' for details.
 
=== Setting: "Remote control sends keyboard presses" ===
* The setting "Remote control sends keyboard presses" from {{highlight|bordered=yes|Settings → System → Input devices}} has been removed. This setting allowed remotes that emulated keyboards to be able to select letters on the on-screen-keyboard. This is now automatically enabled, and the setting is no longer needed.


=== Userdata folder ===
=== Userdata folder ===
* The '''[[userdata folder]]''''s parent settings folder has been renamed from "xbmc" to "kodi" (or .kodi for some OSes).  
* The '''[[Userdata|userdata folder]]''''s parent settings folder has been renamed from "xbmc" to "kodi" (or .kodi for some OSes).  
* If you are upgrading from an older XBMC install, then Kodi will move/rename your "xbmc" folder to "kodi".
* If you are upgrading from an older XBMC install, then Kodi will move/rename your "xbmc" folder to "kodi".


== Troubleshooting ==
{{main|Troubleshooting}}
=== What are some of the known issues in Helix? ===
{{Main|Common issues}}
* Some Amlogic-based Android devices are having issues playing back video, either too zoomed in or only showing a black screen. This will be fixed in the upcoming v14.1 bugfix release: http://forum.kodi.tv/showthread.php?tid=213108
* Some x86-based Android devices crash when using v14. This will be fixed in the upcoming v14.1 bugfix release: http://forum.kodi.tv/showthread.php?tid=213108
* iOS devices will still show Kodi has having an update available even after it is installed.
* ATV2 users need to manually uninstall the old XBMC icon in order for things to run smoothly. See '''[[Migration]]'''.
* ATV2 users who previously auto-booted into XBMC might have issues upgrading to v14. See '''[[Migration]]'''.
* If you use IPTV Simple and your "Live TV" option disappeared, this is not because of the v14 upgrade. The Live TV option for IPTV Simple will disappear if it cannot access the playlist for the channels, such as a URL change or a server issue, or if someone has deleted the playlist.
* Ubuntu might be "stealing" media keys (play, fast forward, volume, etc) and need to be "unmapped" in Ubuntu's keyboard shortcut settings.
* Sometimes add-ons and/or add-on updates might not work until you do a '''[[force refresh]]''' on the add-on repositories.
* If you cannot see any letters on the on-screen-keyboard then you need to switch to a v14-compatible skin or wait for an update for your existing skin.


=== What might break when upgrading to v14? (add-ons, skins, remotes, etc) ===
=== What might break when upgrading to v14? (add-ons, skins, remotes, etc) ===
Line 103: Line 85:
:** Skins that have not been updated might not show the '''on screen keyboard'''.
:** Skins that have not been updated might not show the '''on screen keyboard'''.


:* Should your repo appear empty, or you are missing the new subtitles services, you may need to trigger a [[Add-on manager#Force refresh|Force refresh]] on the Kodi add-on repository.
:* Should your repo appear empty, or you are missing the new subtitles services, you may need to trigger a Force refresh on the Kodi add-on repository.
 
:* The default username for remote smartphone apps is now '''kodi''' and might need to be changed in the settings of those remote apps. You can also change the username back to "xbmc" or use a custom username (and optionally, a password) in '''Service settings'''.
 
=== No menus on screen when starting up ===
* When using the default skin, Confluence, if you only see the blue bubble background and no menus or buttons, this might be due to the start up window option. If the start up window option was set to open up PVR/Live TV in v13, then Kodi gets "confused" in v14 and doesn't show anything. To fix this, press escape until you see the home screen and then go into {{highlight|bordered=yes|Settings → Appearance → Skin → Startup window}} and re-set this to either "home screen" or "TV" if you want to keep starting up on Live TV.
 
=== Add-ons don't show Kodi updates ===
* Sometimes add-ons and/or add-on updates might not work until you do a '''force refresh''' on the add-on repositories.
 
=== No letters on the on-screen-keyboard ===
* If you cannot see any letters on the on-screen-keyboard then you need to switch to a v14-compatible skin or wait for an update for your existing skin.
 
=== No Live TV button on home screen ===
* If you use IPTV Simple and your "Live TV" option disappeared, this is not because of the v14 upgrade. The Live TV option for IPTV Simple will disappear if it cannot access the playlist for the channels, such as a URL change or a server issue, or if someone has deleted the playlist.
* Make sure you are using the included version of IPTV Simple and not an installed version (except for Ubuntu). If you've installed IPTV Simple from another add-on repo or zip file, uninstall that using the [[add-on manager]] and then enable the built-in version by going to {{highlight|bordered=yes|[[Add-on manager|System → Add-ons → Disabled add-ons → PVR]]}}.


:* The default username for remote smartphone apps is now '''kodi''' and might need to be changed in the settings of those remote apps. You can also change the username back to "xbmc" or use a custom username (and optionally, a password) in '''[[Settings/Services/Webserver|Service settings]]'''.
=== Playing a video from home screen or smartphone remote doesn't save watched/resume status ===
* This has since been fixed since the v14.1 bugfix update.
 
=== Empty TV shows are removed when the library is cleaned ===
* See here for full details and the future of this behavior: http://forum.kodi.tv/showthread.php?tid=214908&pid=1891410#pid1891410
* In v14 you must set the [[Advancedsettings.xml#videolibrary|<hideemptyseries> tag to true in advancedsettings.xml]] to prevent empty series from being removed during library cleanup.
 
=== ANDROID: No video or zoomed in video ===
* Some Amlogic-based Android devices are having issues playing back video, either too zoomed in or only showing a black screen. This has since been fixed in the v14.1 bugfix update.
 
=== ANDROID: the x86 (Intel) version of Kodi doesn't work/keeps crashing ===
* Some x86-based Android devices crash when using v14. This has been fixed as of the v14.1 bugfix update.
 
=== APPLE TV 2: Autobooting into XBMC/Kodi causes black screen ===
* ATV2 users who previously auto-booted into XBMC might have issues upgrading to v14. This can be fixed by SSH'ing into the ATV2 (username:''root'' , password:''alpine'') and running the command <pre>apt-get remove org.tomcool.xbmc-booter</pre> and then rebooting the ATV2.
 
=== APPLE TV 2: Two icons for XBMC and Kodi (may cause crashing) ===
* ATV2 users need to manually uninstall the old XBMC icon in order for things to run smoothly.  
 
=== LINUX: Media keys don't work (play, fast forward, volume) ===
* In some Linux distributions (Ubuntu, Linux Mint), the OS might be "stealing" media keys (play, fast forward, volume, etc). A temp workaround is to "un-map" the media keys in the OS's keyboard/shortcut settings.
 
=== RASPBERRY PI: Can't playback RAR files ===
* On most Raspberry Pi builds of Kodi, the ability to browse RAR files has been turned off to prevent out-of-memory crashes with some problematic RAR files. The feature can be manually turned on by going to: {{highlight|bordered=yes|Settings -> Appearance -> File lists -> Support browsing into archives}}
 
=== WINDOWS: Crashing when using webserver or smartphone remote ===
* This has since been fixed as of the v14.2 bugfix update.


=== Where can I get more help? ===
=== Where can I get more help? ===
:The '''[[FAQ|general and platform specific FAQs]]''', the Kodi support forums: '''http://forum.kodi.tv''',  and/or the '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
:The Kodi support forums: '''http://forum.kodi.tv''',  and/or the '''[irc://irc.freenode.org/kodi #kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
 


== See also ==
{{Upgrade FAQs}}


[[Category:FAQ]]
[[Category:Releases|Helix]]
[[Category:Manual]]
[[Category:Helix|*]]
[[Category:Upgrade FAQ|14]]

Latest revision as of 20:19, 11 December 2020


Frequently Asked Questions for upgrading to Kodi v14 (codename Helix) from a previous version. Includes how to enable some of the new features, where some controls got moved to, etc.


General FAQ

See also: All platforms FAQ for an FAQ that applies to all versions of Kodi.

What is Kodi? What is Helix?

Kodi is the new name for XBMC media center. "Helix" is the codename for version 14, just as "Gotham" was the codename for XBMC v13. You will often see "v14" and "Helix" used interchangeably in the community. It might be a little confusing with so many new names being used, but this is simply the new version of XBMC. As long as you call it version 14/v14/Helix, then everyone will know what you are talking about.



You can download Kodi v14 "Helix" by going to http://kodi.tv/download/

Changelog

See: Kodi v14 (Helix) changelog (and add-on developers should also see Helix API changes)

What are some of the major new features?

Examples include:
  • Different selectable keyboard layouts for the on screen keyboard.
  • faster library scraping
  • updated ffmpeg including things like h.265 support
  • software decoding defaults to multithread decoding
  • more control over add-ons and their updates in the add-on manager
  • "big font" size in Confluence
  • Freescale i.MX6 support
  • ATSC sub channels for PVR in the US
  • PVR window changes for easier navigation and new EPG views (now/next/channel)
  • Archives (zip, bin, etc) files can be directly browsed

Upgrading

How do I upgrade to v14?

Note: Always backup your settings before upgrading, just incase!

  • In most cases you can just install Kodi v14 over XBMC v13. All your settings and library are saved and will continue to work in the new version.
  • WARNING: Android users: Do not uninstall XBMC v13 before installing Kodi v14. Doing so will erase your settings before the upgrade takes place.
  • After you install Kodi v14, you can then uninstall your old XBMC v13 install. XBMC v13 must be manually uninstalled in most cases since the upgrade has a new application name, depending on your OS.

See Archive:Migration from XBMC to Kodi for full details.

PVR add-ons for Ubuntu

  • PVR add-ons for Ubuntu need to be reinstalled as they will have new Kodi- names.

MySQL

  • As long as your MySQL server is set up to allow XBMC/Kodi to make new databases for the upgrade itself (see MySQL/Upgrading) then you don't need to do anything for upgrading a MySQL set up for Kodi. Even if you use "XBMC" in your advancedsettings.xml file, you can leave this the same and everything will still work.

Where did it this or that go?

Play button on remote no longer pauses

  • Custom keymaps might need to be adjusted to use the action ID playpause instead of play. "Play" alone has new behavior to only play and not pause. This can be done with a basic text editor and going into your userdata folder and into the keymaps folder.

Live TV

  • The Live TV home menu option has been renamed to just TV.
  • Some Keymap window IDs for PVR have changed and will need to be adjusted accordingly.

Audio encoder options

For Ubuntu users (and possibly other linux-based OSes), audio encoders are now binary add-ons and must be installed through apt-get.

Setting: "Remote control sends keyboard presses"

  • The setting "Remote control sends keyboard presses" from Settings → System → Input devices has been removed. This setting allowed remotes that emulated keyboards to be able to select letters on the on-screen-keyboard. This is now automatically enabled, and the setting is no longer needed.

Userdata folder

  • The userdata folder's parent settings folder has been renamed from "xbmc" to "kodi" (or .kodi for some OSes).
  • If you are upgrading from an older XBMC install, then Kodi will move/rename your "xbmc" folder to "kodi".


What might break when upgrading to v14? (add-ons, skins, remotes, etc)

Most things from v13 will work in v14. However:
  • Some add-ons may not work, prompting Kodi to ask you to disable them. You can keep using them if you wish (by choosing not to disable them), but doing so is unsupported.
  • Some skins might not be updated for v14 Helix when you update. Be sure to check the relevant section of http://forum.kodi.tv for your skin to see if an update is planned.
    • Skins that have not been updated might not show the on screen keyboard.
  • Should your repo appear empty, or you are missing the new subtitles services, you may need to trigger a Force refresh on the Kodi add-on repository.
  • The default username for remote smartphone apps is now kodi and might need to be changed in the settings of those remote apps. You can also change the username back to "xbmc" or use a custom username (and optionally, a password) in Service settings.

No menus on screen when starting up

  • When using the default skin, Confluence, if you only see the blue bubble background and no menus or buttons, this might be due to the start up window option. If the start up window option was set to open up PVR/Live TV in v13, then Kodi gets "confused" in v14 and doesn't show anything. To fix this, press escape until you see the home screen and then go into Settings → Appearance → Skin → Startup window and re-set this to either "home screen" or "TV" if you want to keep starting up on Live TV.

Add-ons don't show Kodi updates

  • Sometimes add-ons and/or add-on updates might not work until you do a force refresh on the add-on repositories.

No letters on the on-screen-keyboard

  • If you cannot see any letters on the on-screen-keyboard then you need to switch to a v14-compatible skin or wait for an update for your existing skin.

No Live TV button on home screen

  • If you use IPTV Simple and your "Live TV" option disappeared, this is not because of the v14 upgrade. The Live TV option for IPTV Simple will disappear if it cannot access the playlist for the channels, such as a URL change or a server issue, or if someone has deleted the playlist.
  • Make sure you are using the included version of IPTV Simple and not an installed version (except for Ubuntu). If you've installed IPTV Simple from another add-on repo or zip file, uninstall that using the add-on manager and then enable the built-in version by going to System → Add-ons → Disabled add-ons → PVR.

Playing a video from home screen or smartphone remote doesn't save watched/resume status

  • This has since been fixed since the v14.1 bugfix update.

Empty TV shows are removed when the library is cleaned

ANDROID: No video or zoomed in video

  • Some Amlogic-based Android devices are having issues playing back video, either too zoomed in or only showing a black screen. This has since been fixed in the v14.1 bugfix update.

ANDROID: the x86 (Intel) version of Kodi doesn't work/keeps crashing

  • Some x86-based Android devices crash when using v14. This has been fixed as of the v14.1 bugfix update.

APPLE TV 2: Autobooting into XBMC/Kodi causes black screen

  • ATV2 users who previously auto-booted into XBMC might have issues upgrading to v14. This can be fixed by SSH'ing into the ATV2 (username:root , password:alpine) and running the command
    apt-get remove org.tomcool.xbmc-booter
    and then rebooting the ATV2.

APPLE TV 2: Two icons for XBMC and Kodi (may cause crashing)

  • ATV2 users need to manually uninstall the old XBMC icon in order for things to run smoothly.

LINUX: Media keys don't work (play, fast forward, volume)

  • In some Linux distributions (Ubuntu, Linux Mint), the OS might be "stealing" media keys (play, fast forward, volume, etc). A temp workaround is to "un-map" the media keys in the OS's keyboard/shortcut settings.

RASPBERRY PI: Can't playback RAR files

  • On most Raspberry Pi builds of Kodi, the ability to browse RAR files has been turned off to prevent out-of-memory crashes with some problematic RAR files. The feature can be manually turned on by going to: Settings -> Appearance -> File lists -> Support browsing into archives

WINDOWS: Crashing when using webserver or smartphone remote

  • This has since been fixed as of the v14.2 bugfix update.

Where can I get more help?

The Kodi support forums: http://forum.kodi.tv, and/or the #kodi IRC chat channel on irc.freenode.org.