Archive:XBMC v13 (Gotham) FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Undo revision 62276 by Ned Scott (talk))
mNo edit summary
 
(133 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{mininav|[[General topics]]|[[FAQs]] }}
<section begin="intro" />Frequently Asked Questions for upgrading to XBMC v13 (Gotham) from a previous version. Includes how to enable some of the new features, where some controls got moved to, etc.<section end="intro" />
{{FAQ header|upgrading to XBMC v13 (Gotham), including how to enable some of the new features, where some controls got moved to, etc.}}
 
{{XBMC FAQ}}
__TOC__
__TOC__
{{-}}
{{-}}
== General FAQ ==
== General FAQ ==
:<big>''See also: '''[[XBMC all platforms FAQ]]''' for an FAQ that applies to all versions of XBMC.''</big>
:{{big|''See also: '''All_platforms_FAQ''' for an FAQ that applies to all versions of XBMC.''}}
{| width="100%"


{{FAQ|1=Gotham
=== What is "Gotham"? ===
| BGcolor=WhiteSmoke
:Gotham is the codename for XBMC Media Center version 13 and can be downloaded from http://xbmc.org/download/ . You will often see "v13" and "Gotham" used interchangeably in the XBMC community.
| Question=What is "Gotham"?
| Answer=
{{see also|History of XBMC}}
Gotham is the codename for [[XBMC Media Center]] version 13. Current release date is unknown and will be communicated through official channels when decided. You will often see "v13" and "Gotham" used interchangeably in the XBMC community.


}}
* [http://xbmc.org/xbmc-13-0-gotham-rises/ '''XBMC v13.0''' was released on May 4th 2014]
* [http://xbmc.org/xbmc-13-1-gotham-returns/ '''XBMC v13.1''', bugfix update, was released on June 5th 2014]
* [http://xbmc.org/xbmc-13-2-gotham-final-release/ '''XBMC v13.2''', bugfix update, was released on Augest 17th 2014]


{{FAQ|1=changelog
=== Changelog ===
| BGcolor=
:See: '''[[Archive:XBMC_v13_(Gotham)_changelog]]''' (and add-on developers should also see '''[[Archive:Gotham_API_changes]]''')
| Question=Where can I see a full changelog?
| Answer=
''See: '''[[XBMC v13 (Gotham) changelog]]'''''
}}


{{FAQ|1=installing
=== How do I upgrade to v13? ===
| BGcolor= WhiteSmoke
{{Note|Always '''[[backup]]''' your '''[[Userdata]] folder''' before upgrading, just in case!}}
| Question=How do I upgrade to v13?
| Answer=
Just install/copy the new version of XBMC over the old one.
* [[HOW-TO:Install XBMC on Apple TV 1|Apple TV 1 (silver)]]
* [[HOW-TO:Install XBMC on Apple TV 2|Apple TV 2 (black)]]
* [[HOW-TO:Install XBMC on iPad/iPhone/iPod touch|iOS devices]]
* [[HOW-TO:Install XBMC for Linux|Linux]]  
* [[XBMC for Linux specific FAQ#Ubuntu manual XBMC upgrade process|XBMC Linux_FAQ > Upgrade in Ubuntu properly]] short how-to upgrade XBMC in Linux.
* [[XBMCbuntu#How To Install XBMC Live|How to install XBMCbuntu]]
* [[HOW-TO:Install XBMC for Mac|Mac]]
* [[HOW-TO:Install XBMC for Windows|Windows]]
* Openelec and other pre-made Linux distros - Wait for them to push an update or manually install a Gotham build
}}


{{FAQ|1=New_features
:Just install/copy the new version of XBMC over the old one.
| BGcolor=
:* HOW-TO:Install XBMC on Apple TV 1|Apple TV 1 (silver)
| Question= What are some of the major new features?
:* HOW-TO:Install XBMC on Apple TV 2|Apple TV 2 (black)
| Answer=
:* HOW-TO:Install XBMC on iPad/iPhone/iPod touch|iOS devices
:''See '''[[XBMC v13 (Gotham) changelog]]''' for a full list of changes''
:* HOW-TO:Install XBMC for Linux|Linux
* ... [[XBMC v13 (Gotham) changelog|and much much more]]
:* XBMC for Linux specific FAQ#Ubuntu manual XBMC upgrade process|XBMC Linux_FAQ > Upgrade in Ubuntu properly short how-to upgrade XBMC in Linux.
}}
:* XBMCbuntu#How To Install XBMC Live|How to install XBMCbuntu
:* HOW-TO:Install XBMC for Mac
:* HOW-TO:Install XBMC for Windows|Windows
:* Openelec and other pre-made Linux distros - Wait for them to push an update or manually install a Gotham build


{{FAQ|1=settings
=== What are some of the major new features? ===
| BGcolor= WhiteSmoke
::''See '''[[Archive:XBMC_v13_(Gotham)_changelog]]''' for a condensed list of large and important changes''
| Question=Will I lose my settings/library in the upgrade?
:Examples include:
| Answer=
:* '''3D playback''' improvements and GUI support.
For most users, no. All settings and your library will be preserved in an upgrade. Settings that aren't preserved are those that have been reorganised, renamed, set to a new default - usually it's only a handful, and only things that don't really matter. However, it never hurts to do a backup of your [[userdata]] folder (where all the settings/library DB files are stored).
:* '''[[Android hardware|Android hardware video decoding]]''' for most Android devices, allowing HD playback.
:* '''[[Wake_on_lan]]''' to wake NAS devices and other network shares, on-demand.
:* '''[[Bookmarks_and_chapters|Episode bookmarks]]''' for video files or ISOs that contain more than one episode.
:* '''[[Movie sets]]''' now can now be managed (edit, remove, add) within XBMC.
:* '''Sending video to UPnP/DLNA targets''' such as other XBMC instances and even some smart TVs.
:* '''Improved UPnP library sharing''' including resume points and watched status.
:* '''New network cache options'''
:* '''[[Touch controls|Customizable touch screen controls]]'''
:* '''[[HOW-TO:Set_up_subtitle_services|Improved subtitle download features]]'''
:* '''Simplified audio settings''' and improved underlying '''[[audio|audio engine]]'''.
:* ... [[Archive:XBMC_v13_(Gotham)_changelog|and much much more]]


If you are using MySQL then see [[#MySQL]]'''
=== Will I lose my settings/library in the upgrade? ===
}}
:{{see also|Backup}}
{{FAQ|1=MySQL
:For most users, no. All settings and your library will be preserved in an upgrade. Settings that aren't preserved are those that have been reorganised, renamed, set to a new default - usually it's only a handful, and only things that don't really matter. However, it never hurts to do a backup of your [[Userdata]] folder (where all the settings/library DB files are stored).
| BGcolor=
| Question=Do I need to do anything for MySQL library syncing?
| Answer=
Yes, See: '''[[HOW-TO:Sync multiple libraries/Upgrading XBMC to v13]]'''
}}


{{FAQ|1=PVR|2=DVR|3=Live TV
:'''If you are using MySQL then see [[MySQL/Upgrading]].'''
| BGcolor= WhiteSmoke
| Question=How do I use Live TV/PVR?
| Answer=
{{main|PVR}}
See our guide at '''[[PVR]]''' for help in setting this up and more information about the feature.
}}


{{FAQ|1=Local_images
=== MySQL special instructions? ===
| BGcolor=  
:See '''[[MySQL/Upgrading]]'''
| Question= How should local images be named for Gotham?
| Answer=
{{see also|Thumbnails}}
Since Frodo it supports both posters and banners simultaneously, and for other supported images, the following naming conventions are available for local images (Only required if the user wants to specify what image to use. Otherwise XBMC will automatically download images from the video scraper). Whenever possible, old Eden style naming is supported for backwards compatibility.


;For folders (e.g. tvshows, movies in folders, or just folders on the filesystem):
=== Why does Chrome think my XBMC download is malicious? ===
* poster.(png/jpg)
:Because Chrome uses a retarded method of marking everything as malicious unless they've specifically looked at it. Please complain to Google about this, because we don't like it either.
* banner.(png/jpg)
* fanart.(png/jpg)
{{note|Movies in folders can also use the options under files below.}}
;Season images reside inside the tvshow folder:
* season[XX]-(poster/banner/fanart).(png/jpg)
* season-all-(poster/banner/fanart).(png/jpg}
* season-specials-(poster/banner/fanart).(png/jpg)
;For files (episodes, movies not in folders, video files):
* [moviename]-(poster/banner/fanart).(png/jpg)
* [episodename]-thumb.(png/jpg)
* [filename]-(poster/banner/fanart).(png/jpg)
}}


{{FAQ|1=Dirty_Regions
== Where did it this or that go? ==
| BGcolor= WhiteSmoke
| Question= Do I still need advancedsettings for Dirty Regions?
| Answer=
'''[[Dirty Regions]]''' has a new default, but you might still want to keep your existing advancedsettings.xml entry. The default is mode 3, which will reduce CPU load, but won't make the GUI any faster (it's considered the safest mode for all the various GPUs out there). If you're using anything other than mode 3 in order to make the GUI more efficient, then you will want to keep your advancedsettings.xml file the same.
}}
|}


== Where did it this or that go? ==
=== Where did most of the settings go? ===
{| width="100%"
[[File:Confluence - settings level.jpg|right|500px]]
:Gotham now has multiple user levels for settings. Hiding some more advanced settings by default. To change this setting level just select the button/label that says "Settings level". Not all skins have been adapted to this change. If you cannot find this side panel, you must switch to the Confluence skin to enable these options. After this you can switch back to the skin you normally use.
{{-}}
 
=== How do I use subtitle downloads now? ===
:* See: '''[[HOW-TO:Set_up_subtitle_services|HOW-TO:Setup subtitle services]]''' for how to set up the subtitle download services in v13.
:* If you have bound a remote key to bring up the subtitle search window, you will need to update the [[keymap]] to use this instead: <code>ActivateWindow(subtitlesearch)</code>
 
=== LCD/VFD settings? ===
:The LCD/VFD functionality in XBMC has been spun-out into an add-on. Full functionality for LCD/VFD displays is included, plus new improvements and bugfixes. See '''LCDs''' for more details.
 
=== Flatten view option? ===
:The "Flatten" option that used to be in the left hand sidebar menu is now a setting under {{highlight|bordered=yes|XBMC -> Settings -> Videos -> Library -> '''Flatten library hierarchy'''}}


{{FAQ|1=All_settings
=== Stack view option? ===
| BGcolor=
:The "Stack" option that used to be in the left hand sidebar menu is now a setting under {{highlight|bordered=yes|XBMC -> Settings -> Videos -> File lists -> '''Combine split video items'''}}
| Question= Where did most of the settings go?
| Answer=
Gotham now has multiple user levels of settings. Hiding some more advanced settings by default. To change this setting level {{highlight|[[Settings/Appearance#Skin|Settings -> Appearance -> Press left -> Change setting level]]}}.
}}


{{FAQ|1=Skin_settings
| BGcolor=WhiteSmoke
| Question= Where did the Skin settings page go?
| Answer=
The Skin settings page has been moved to {{highlight|[[Settings/Appearance#Skin|Settings -> Appearance -> Skin -> Settings]]}}.
}}


{{FAQ|1=Confluence_bg
[[File:Confluence side menu - update library.jpg|500px|right]]
| BGcolor=
=== Update library button? ===
| Question= Where are the multiple backgrounds for Confluence (default skin)?
:The update library button has been moved from the out of the context menu and into the left side blade menu in library mode, when using the default Confluence skin.
| Answer=
The default skin in XBMC, Confluence, now only supports one background for the home screen instead of different background for reach selected home option (movies, TV, pictures, etc).
}}


{{FAQ|1=Network_settings|2=Services_settings
=== Now-playing/current playlist? ===
| BGcolor= WhiteSmoke
:The "Now playing" button has been moved out of the context menu and into the left side blade menu. It has also been renamed to "'''Currently playing'''".
| Question= Where did the Network settings page go?
{{-}}
| Answer=
The Network settings page ({{highlight|Settings -> Network}}) has been replaced by the '''[[Settings/Services|Services settings page]]''' ({{highlight|[[Settings/Services|Settings -> Services]]}}).
}}


{{FAQ|1=Internet_settings
== Music library ==
| BGcolor=
=== MusicBrainzID ===
| Question= Where did the Internet access settings page go?
{{Warning|If you are unfamiliar with MusicBrainzIDs or what that might mean for your library, be sure to backup your '''[[Userdata]] folder''' before upgrading, as these changes might alter how your music library is displayed.}}
| Answer=
:XBMC v13 Gotham has new "MusicBrainzID" integration. This allows your music metadata to be updated automatically when that data is updated on the MusicBrainz database ''if'' the music has MusicBrainz ID tags.
The Internet settings page has been moved to {{highlight|[[Settings/System#Internet access|Settings -> System -> Internet access]]}}.
}}


{{FAQ|1=Slideshow
* ''MusicBrainz tag reading/online overriding'' is enabled by default. The setting for this can be found in {{highlight|bordered=yes|Settings -> Media -> Music -> '''Prefer online information'''}}
| BGcolor= WhiteSmoke
| Question= Where did the Slideshow screensaver go?
| Answer=
The [[Add-on:Slideshow|Slideshow screensaver is now an add-on]] and needs to be installed as such. You can do this from the [[add-ons|add-on manager]] or by going to {{highlight|[[Settings/Appearance#Screensaver|Settings -> Appearance -> Screensaver]] -> Screensaver mode ->  Get more -> Slideshow -> Install}}.
}}


{{FAQ|1=Weather
| BGcolor= WhiteSmoke
| Question= Where did weather go?
| Answer=
The [[Add-on:Wunderground|Wunderground service]] has been removed in fresh installs because of high load on the providers and needs to be installed manually if desired. You can do this from the [[add-ons|add-on manager]] or by going to {{highlight|[[Settings/Weather -> General -> Services for weather information]] -> Get more -> Choose service -> Install}}.
}}


|}
; The new behavior goes as follows


== Audio (all operating systems) ==
:* If you don't have MusicBrainz tags and you have the option turned off, you should see the exact same as you saw in v12 Frodo.
{| width="100%"
:* If you don't have MusicBrainz tags and you have the option turned on, you should see the exact same as you saw in v12 Frodo.
{{FAQ|1=AudioEngine|2=HD audio
:* If you have MusicBrainz tags and you have the option turned off, you should see the exact same as you saw in v12 Frodo.
| BGcolor=
:* If you have MusicBrainz tags and you have the option turned on, you should get dynamic metadata from MusicBrainz. i.e. once you've MusicBrainz tagged your files once, your library and metadata is built dynamically from up-to-date MusicBrainz data, and later kept up-to-date and refreshed automatically so you always have good tags.
| Question= Does Gotham have HD audio passthrough support?
| Answer=
Yes, since Frodo it has HD audio passthrough support, thanks to the new '''[[AudioEngine]]'''.


"HD audio" is a term for two audio formats (DTS-MA and TrueHD) that are most commonly found in some bluray discs. XBMC has supported these formats in the past, but has not been able to pass them on (passthrough) to audio receivers for maximum bit-perfect audio quality, until now. If you have an HD audio compatible sound system then check out the [[AudioEngine]] page for more information.
== Audio ==


'''''See also:''''' [[AudioEngine#HD audio limitation of AMD fglrx in Linux|'''ATI HD Audio Limitation in Linux''']]
=== General audio ===
}}
:XBMC v13 Gotham changes a number of things for audio and audio settings. For further details on audio topics see our new section on audio: '''[[Audio]]'''


{{FAQ|1=Mac_AE
== Android ==
| BGcolor= WhiteSmoke
| Question=Does XBMC for Mac OS X, iOS, or Apple TV 2 have HD audio passthrough?
| Answer=
While XBMC for Mac OS X does have the new [[AudioEngine]], which features many new improvements in audio quality for XBMC, HD audio passthrough is not currently possible on Mac OS X and iOS due to limitations on the OS level. Those who want HD audio passthrough will need to use a Linux-based OS or Windows on their Mac hardware. Note that XBMC for Mac OS X/iOS is still able to playback HD audio, just not via passthrough (it will be converted to another format before playback).
}}


{{FAQ|1=Audio
=== Why is XBMC not in the Google Play/ Amazon/ OUYA store? ===
| BGcolor=
<section begin="app stores" />
| Question= Audio issues and/or slow video playback
:During the time between XBMC v12 and v13, an unofficial version of XBMC in the OUYA store ''(XBMC on OUYA)'' had to remove '''software decoding''' of AC3 and DTS by demand of the companies that owned those audio formats. The only way to enable '''software decoding''' of those formats would be to pay a licensing fee. The same thing happened for several video player apps on the Google Play store.  
| Answer=  
{{See also|Settings/System#Audio output}}
Make sure that your audio settings are correct. Wrong audio settings will have severely negative effects on video playback:
* Your speaker setup is really correct
* If passthrough: you '''only''' enable the audio codecs your receiver supports.
* Select only the correct audio output device for analog and passthrough
;Linux specific
* On AMD GPUs you must disable all "HD" passthrough options and "output stereo to all speakers". AMD drivers under Linux don't support HD audio passthrough. AC3 and DTS should be safe to enable. NVidia GPUs should be okay for HD audio (if supported by the hardware).
* Having issues on XBMCbuntu? See '''[[XBMCbuntu#XBMCbuntu no audio devices]]'''
;Mac OS X specific
* If you hear sound only coming from the left side of speakers/headphones then you probably need to change your audio settings from 2.1 to 2.0.
;Windows specific
* Most user can fix their issue by just switching to "DirectSound" in the [[Settings/System#Audio output|audio settings]]. See '''[[Windows Settings for AudioEngine]]''' for more in-depth information.
;OS X and iOS known issues
{{#lst:Gotham issues|Mac audio}}
}}
|}


== Linux ==
:Well, crap.
{| width="100%"
{{FAQ|1=Debian_repo
| BGcolor= WhiteSmoke
| Question= Why is Gotham not in the default Debian/Ubuntu repositories?
| Answer=
{{#lst:HOW-TO:Install XBMC for Linux|Debian}}


Until that is resolved Ubuntu users can still get XBMC from our official PPAs by adding the Team XBMC repository: https://launchpad.net/~team-xbmc/+archive/ppa , which has the additional advantage of working LibRAR support.
:Because of this, Team XBMC is considering their options. We don't want to remove features or ever charge money for XBMC just to expose it in an app store. We also want to make XBMC easily accessible to as many people as reasonably possible.
}}


{{FAQ|1=Older_Ubuntu
:For the time being, you can always sideload the full version of XBMC from the apk downloads from xbmc.org. See '''[[HOW-TO:Install_Kodi_for_Android]]''' for details.<section end="app stores" />
| BGcolor=
| Question= Where can I get Gotham builds for older Ubuntu installations?
| Answer=
* https://launchpad.net/~nathan-renniewaldock/+archive/xbmc-stable '''ppa:nathan-renniewaldock/xbmc-stable'''
}}


{{FAQ|1=XVBA
=== There are two versions of XBMC for Android. Which one do I use? ===
| BGcolor= WhiteSmoke
:The vast majority of users will want to use the [http://mirrors.kodi.tv/releases/android/arm/ "ARM" version]. Users who have an Android device with an Intel or AMD CPU will want to use the [http://mirrors.kodi.tv/releases/android/x86/ "x86" version].
| Question= Does Gotham have XVBA support?
| Answer=  
XVBA support has not yet been merged into the main XBMC code branch, but you can find XVBA builds here:
* Tested Git builds: https://launchpad.net/~wsnipex/+archive/xbmc-xvba '''ppa:wsnipex/xbmc-xvba'''
* Gotham stable: https://launchpad.net/~wsnipex/+archive/xbmc-xvba-Gotham '''ppa:wsnipex/xbmc-xvba-Gotham'''
}}


{{FAQ|1=XBMCbuntu_update
== Linux ==
| BGcolor=  
=== How to switch from XBMC unstable PPA (used in XBMCbuntu Beta/RC releases) to final PPA ===
| Question= How to switch from XBMC unstable PPA (used in XBMCbuntu Beta/RC releases) to final PPA
:<syntaxhighlight lang=bash enclose="div">
| Answer=  
<source lang="bash">
sudo add-apt-repository -r ppa:team-xbmc/unstable
sudo add-apt-repository -r ppa:team-xbmc/unstable
sudo add-apt-repository ppa:team-xbmc/ppa
sudo add-apt-repository ppa:team-xbmc/ppa
Line 234: Line 131:
sudo apt-get upgrade
sudo apt-get upgrade
sudo apt-get install xbmc xbmc-bin
sudo apt-get install xbmc xbmc-bin
</source>
</syntaxhighlight>
}}
|}


== Mac OS X ==
== Windows ==
{| width="100%"
=== SMB/CIFS UNC paths no longer work ===
{{FAQ|1=Mac_OS
: SMB media sources that use UNC paths ( such as <code>\\server\path\to\share</code>) are no longer supported in XBMC v13 and need to be converted before upgrading XBMC. There are a few ways to do this, such as what is shown on '''[[Backup]]'''. You can also use "Single file" export/import and then open the exported XML file and use find/replace to update the paths.
| BGcolor=  
| Question= New Mac requirements
| Answer=
XBMC v13 for Mac OS X changes the hardware requirements. PowerPC (PPC) support has been dropped, so XBMC for Mac will only run on Intel processors. Mac OS X 10.6 is now the minimum requirement for the operating system.
}}


{{FAQ|1=ATV1
: The UNC style paths were never fully compatible with XBMC and often caused various issues. In order to fix those issues and properly support SMB, the decision was made to drop support for UNC paths. Users should instead use the format <code>smb://server/path/to/share/</code> or the internal XBMC SMB browser to add those media sources.
| BGcolor= WhiteSmoke
| Question= Will Gotham run on Apple TV 1 (silver)?
| Answer=
Yes, but only if it is running linux. XBMC v13 requires Mac OS X 10.6 and up, and the ATV1 OS is based on Mac OS X 10.4. See '''[[Apple TV 1 FAQ]]''' for info on updating to a linux OS.
}}
|}


== Raspberry Pi ==
{{Note|If you've already updated to v13, '''don't panic'''. XBMC keeps a v12-friendly copy of your database that you can go back to in order to migrate your library to the updated URL paths. Just reinstall XBMC v12 over v13 and from there you can export your library.}}
{|width="100%"
{{FAQ|1=Raspberry_Pi
| BGcolor=
| Question= XBMC for Raspberry Pi
| Answer=
{{main|Raspberry Pi FAQ}}
For more information on XBMC on the R-Pi, including how to install it, see '''[[Raspberry Pi FAQ]]'''.
}}
|}
 
== Android ==
{| width="100%"
{{FAQ|1=Android
| BGcolor= WhiteSmoke
| Question= XBMC for Android
| Answer=
{{See also|Android FAQ|HOW-TO:Install XBMC for Android}}
* While there is a v13 XBMC for Android release, not all features work on all Android devices yet. This was expected, but a release is still made for those who wish to try it out. Several features, such as hardware video decoding, better touch support, and more, are still under development. Check out '''[[Android FAQ]]''' for details on continuing developments and new test builds posted regularly.
 
* If you've bought a device that was advertised to run XBMC, such as the Pivos XIOS, G-box, MiniX Neo, etc, then you should check with their respective websites for a final v13 Gotham build. Many of these devices need specific builds for hardware decoding and won't work correctly with the generic build released on xbmc.org.
 
* XBMC for Android won't be on the Google Play store just yet. It will be made available once there is better support for more Android devices.
}}
|}


== Troubleshooting ==
== Troubleshooting ==
{{main|Troubleshooting}}
main|Troubleshooting
{| width="100%"
{{FAQ|1=Issues
| BGcolor=
| Question= What are some of the known issues in Gotham?
| Answer=
''See: '''[[Known Gotham issues]]'''''
}}
 
{{FAQ|1=Audio_troubleshooting
| BGcolor= WhiteSmoke
| Question= Audio issues and/or slow video playback
| Answer=
''See: '''[[#Audio]]''' above.''
}}
 
{{FAQ|1=Movie_sets
| BGcolor=
| Question= Can't use more than one movie set
| Answer=
{{see also|Movie sets|Video library tags}}
v13 only supports one [[movie set]] for movies at a time. The ability to use more than one set in previous versions was actually an oversight, as sets are only meant to be used for directly related sequels and movie series, and the feature doesn't work correctly for more than one. For those who need a way to group movies in various ways, XBMC v13 Gotham now has '''[[video library tags]]''', which can be used as many times as a user wants, and for whatever reason they want.
}}
 
{{FAQ|1=breaking
| BGcolor= WhiteSmoke
| Question=What might break when upgrading to v13? (add-ons, skins, remotes, etc)
| Answer=
Most things from v12 will work in v13. However:
* Add-ons may not work, prompting XBMC 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. See [[:Category:All add-ons]] for a list (check the drop-down menus). Where there is a noticeable slowdown in XBMC addons are likely cause, backup your [[userdata]] and as a last resort delete the [[userdata]] Addons folder and the '''Addons15.db''' in the [[userdata]] Database folder.
* Skins need to be updated for Gotham - check your skin has been upgraded ready for Gotham: [[:Category:Skins]] (check the drop-down menus). If you have problems starting up XBMC after updating, you might need to move/delete your guisettings.xml file (see [[userdata]] for location) to reset your skin.
* If videos are playing back slowly or you have having sound related issues, '''see: [[#Audio]]'''.
}}


{{FAQ|1=Recently_added|2=Date_added
=== Volume or navigation controls seem to stick ===
| BGcolor=  
:If volume controls seem to keep turning volume down, or it seems like something is navigating or pressing a directional key constantly, it might be due to a plugged in gamepad or a laptop's accelerometer sensor being detected as a "joystick" by XBMC. To fix this go to {{highlight|bordered=yes|XBMC -> Settings -> System -> Input devices ->}} and uncheck '''enable joysticks'''.
| Question= Recently added videos seem out of order
| Answer=  
Since Frodo it now uses file dates for "Recently added" videos instead of the date when a video was scanned into XBMC. This can be changed back to XBMC v11 (Eden) behavior by creating a text file called [[advancedsettings.xml#<videolibrary>|advancedsettings.xml]] and placing it in the [[userdata folder]] with the following content:
<source lang="xml">
  <advancedsettings>
      <videolibrary>
        <dateadded>0</dateadded>
      </videolibrary>
  </advancedsettings></source>
}}


{{FAQ|1=reverting
=== What might break when upgrading to v13? (add-ons, skins, remotes, etc) ===
| BGcolor= WhiteSmoke
:Most things from v12 will work in v13. However:
| Question=What happens if I don't like XBMC v13, can I just install XBMC v11 again?
:* Add-ons may not work, prompting XBMC 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. See [[:Category:All add-ons]] for a list (check the drop-down menus). Where there is a noticeable slowdown in XBMC add-ons are likely cause, backup your [[Userdata]] and as a last resort delete the [[Userdata]] Addons folder and the '''Addons15.db''' & '''Addons16.db''' in the [[Userdata]] Database folder.
| Answer=
:* Skins need to be updated for Gotham - check your skin has been upgraded ready for Gotham: [[:Category:Skins]] (check the drop-down menus). If you have problems starting up XBMC after updating, you might need to move/delete your guisettings.xml file (see [[Userdata]] for location) to reset your skin.
Whilst Gotham does "upgrade" the library, it stores a Eden compatible copy. Just replace the Gotham application with Eden. '''It is still recommended to always make a backup of your [[userdata]] folder before updating, just in case.''' Add-ons will likely need to be reset (uninstall and then reinstall) if you go from Gotham to Eden.
:* Should your repo appear empty, or you are missing the new subtitles services, you may need to trigger a  [[Add-on_manager|Force refresh]] on the XBMC.org repository.
}}


{{FAQ|1=emptyrepos
=== What happens if I don't like XBMC v13, can I just install XBMC v12 again? ===
| BGcolor=  
:Whilst Gotham does "upgrade" the library, it stores a Frodo compatible copy. Just replace the Gotham application with Frodo. '''It is still recommended to always make a backup of your [[userdata]] folder before updating, just in case.''' Add-ons will likely need to be reset (uninstall and then reinstall) if you go from Gotham to Frodo.
| Question=What should I do when Addon repositories dont list any contents?
| Answer=
See [[Add-ons#Empty repository list|'''Empty repositories listing''']]
}}


{{FAQ|1=more_help
=== Where can I get more help? ===
| BGcolor= WhiteSmoke
:The '''general and platform specific FAQs''', the XBMC support forums: '''http://forum.kodi.tv''',  and/or the '''[irc://irc.freenode.org/xbmc #xbmc]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
| Question=Where can I get more help?
| Answer=
The '''[[FAQ|general and platform specific FAQs]]''', the XBMC support forums: '''http://forum.xbmc.org''',  and/or the '''[irc://irc.freenode.org/xbmc-osx #xbmc]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.
}}
|}


== See also ==
* [[XBMC v12 (Frodo) FAQ]]
* [[XBMC v11 (Eden) FAQ]]


[[Category:FAQ]]
[[Category:Releases|Gotham FAQ]]
[[Category:XBMC Manual]]
[[Category:Gotham|*]]
{{Gotham updated}}

Latest revision as of 23:26, 29 January 2021

Frequently Asked Questions for upgrading to XBMC v13 (Gotham) 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 XBMC.

What is "Gotham"?

Gotham is the codename for XBMC Media Center version 13 and can be downloaded from http://xbmc.org/download/ . You will often see "v13" and "Gotham" used interchangeably in the XBMC community.

Changelog

See: Archive:XBMC_v13_(Gotham)_changelog (and add-on developers should also see Archive:Gotham_API_changes)

How do I upgrade to v13?

Note: Always backup your Userdata folder before upgrading, just in case!

Just install/copy the new version of XBMC over the old one.
  • HOW-TO:Install XBMC on Apple TV 1|Apple TV 1 (silver)
  • HOW-TO:Install XBMC on Apple TV 2|Apple TV 2 (black)
  • HOW-TO:Install XBMC on iPad/iPhone/iPod touch|iOS devices
  • HOW-TO:Install XBMC for Linux|Linux
  • XBMC for Linux specific FAQ#Ubuntu manual XBMC upgrade process|XBMC Linux_FAQ > Upgrade in Ubuntu properly short how-to upgrade XBMC in Linux.
  • XBMCbuntu#How To Install XBMC Live|How to install XBMCbuntu
  • HOW-TO:Install XBMC for Mac
  • HOW-TO:Install XBMC for Windows|Windows
  • Openelec and other pre-made Linux distros - Wait for them to push an update or manually install a Gotham build

What are some of the major new features?

See Archive:XBMC_v13_(Gotham)_changelog for a condensed list of large and important changes
Examples include:

Will I lose my settings/library in the upgrade?

For most users, no. All settings and your library will be preserved in an upgrade. Settings that aren't preserved are those that have been reorganised, renamed, set to a new default - usually it's only a handful, and only things that don't really matter. However, it never hurts to do a backup of your Userdata folder (where all the settings/library DB files are stored).
If you are using MySQL then see MySQL/Upgrading.

MySQL special instructions?

See MySQL/Upgrading

Why does Chrome think my XBMC download is malicious?

Because Chrome uses a retarded method of marking everything as malicious unless they've specifically looked at it. Please complain to Google about this, because we don't like it either.

Where did it this or that go?

Where did most of the settings go?

Confluence - settings level.jpg
Gotham now has multiple user levels for settings. Hiding some more advanced settings by default. To change this setting level just select the button/label that says "Settings level". Not all skins have been adapted to this change. If you cannot find this side panel, you must switch to the Confluence skin to enable these options. After this you can switch back to the skin you normally use.


How do I use subtitle downloads now?

  • See: HOW-TO:Setup subtitle services for how to set up the subtitle download services in v13.
  • If you have bound a remote key to bring up the subtitle search window, you will need to update the keymap to use this instead: ActivateWindow(subtitlesearch)

LCD/VFD settings?

The LCD/VFD functionality in XBMC has been spun-out into an add-on. Full functionality for LCD/VFD displays is included, plus new improvements and bugfixes. See LCDs for more details.

Flatten view option?

The "Flatten" option that used to be in the left hand sidebar menu is now a setting under XBMC -> Settings -> Videos -> Library -> Flatten library hierarchy

Stack view option?

The "Stack" option that used to be in the left hand sidebar menu is now a setting under XBMC -> Settings -> Videos -> File lists -> Combine split video items


Confluence side menu - update library.jpg

Update library button?

The update library button has been moved from the out of the context menu and into the left side blade menu in library mode, when using the default Confluence skin.

Now-playing/current playlist?

The "Now playing" button has been moved out of the context menu and into the left side blade menu. It has also been renamed to "Currently playing".


Music library

MusicBrainzID

Stop hand.png If you are unfamiliar with MusicBrainzIDs or what that might mean for your library, be sure to backup your Userdata folder before upgrading, as these changes might alter how your music library is displayed.
XBMC v13 Gotham has new "MusicBrainzID" integration. This allows your music metadata to be updated automatically when that data is updated on the MusicBrainz database if the music has MusicBrainz ID tags.
  • MusicBrainz tag reading/online overriding is enabled by default. The setting for this can be found in Settings -> Media -> Music -> Prefer online information


The new behavior goes as follows
  • If you don't have MusicBrainz tags and you have the option turned off, you should see the exact same as you saw in v12 Frodo.
  • If you don't have MusicBrainz tags and you have the option turned on, you should see the exact same as you saw in v12 Frodo.
  • If you have MusicBrainz tags and you have the option turned off, you should see the exact same as you saw in v12 Frodo.
  • If you have MusicBrainz tags and you have the option turned on, you should get dynamic metadata from MusicBrainz. i.e. once you've MusicBrainz tagged your files once, your library and metadata is built dynamically from up-to-date MusicBrainz data, and later kept up-to-date and refreshed automatically so you always have good tags.

Audio

General audio

XBMC v13 Gotham changes a number of things for audio and audio settings. For further details on audio topics see our new section on audio: Audio

Android

Why is XBMC not in the Google Play/ Amazon/ OUYA store?

During the time between XBMC v12 and v13, an unofficial version of XBMC in the OUYA store (XBMC on OUYA) had to remove software decoding of AC3 and DTS by demand of the companies that owned those audio formats. The only way to enable software decoding of those formats would be to pay a licensing fee. The same thing happened for several video player apps on the Google Play store.
Well, crap.
Because of this, Team XBMC is considering their options. We don't want to remove features or ever charge money for XBMC just to expose it in an app store. We also want to make XBMC easily accessible to as many people as reasonably possible.
For the time being, you can always sideload the full version of XBMC from the apk downloads from xbmc.org. See HOW-TO:Install_Kodi_for_Android for details.

There are two versions of XBMC for Android. Which one do I use?

The vast majority of users will want to use the "ARM" version. Users who have an Android device with an Intel or AMD CPU will want to use the "x86" version.

Linux

How to switch from XBMC unstable PPA (used in XBMCbuntu Beta/RC releases) to final PPA

sudo add-apt-repository -r ppa:team-xbmc/unstable
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get remove xbmc xbmc-bin
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install xbmc xbmc-bin

Windows

SMB/CIFS UNC paths no longer work

SMB media sources that use UNC paths ( such as \\server\path\to\share) are no longer supported in XBMC v13 and need to be converted before upgrading XBMC. There are a few ways to do this, such as what is shown on Backup. You can also use "Single file" export/import and then open the exported XML file and use find/replace to update the paths.
The UNC style paths were never fully compatible with XBMC and often caused various issues. In order to fix those issues and properly support SMB, the decision was made to drop support for UNC paths. Users should instead use the format smb://server/path/to/share/ or the internal XBMC SMB browser to add those media sources.

Note: If you've already updated to v13, don't panic. XBMC keeps a v12-friendly copy of your database that you can go back to in order to migrate your library to the updated URL paths. Just reinstall XBMC v12 over v13 and from there you can export your library.

Troubleshooting

main|Troubleshooting

Volume or navigation controls seem to stick

If volume controls seem to keep turning volume down, or it seems like something is navigating or pressing a directional key constantly, it might be due to a plugged in gamepad or a laptop's accelerometer sensor being detected as a "joystick" by XBMC. To fix this go to XBMC -> Settings -> System -> Input devices -> and uncheck enable joysticks.

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

Most things from v12 will work in v13. However:
  • Add-ons may not work, prompting XBMC 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. See Category:All add-ons for a list (check the drop-down menus). Where there is a noticeable slowdown in XBMC add-ons are likely cause, backup your Userdata and as a last resort delete the Userdata Addons folder and the Addons15.db & Addons16.db in the Userdata Database folder.
  • Skins need to be updated for Gotham - check your skin has been upgraded ready for Gotham: Category:Skins (check the drop-down menus). If you have problems starting up XBMC after updating, you might need to move/delete your guisettings.xml file (see Userdata for location) to reset your skin.
  • Should your repo appear empty, or you are missing the new subtitles services, you may need to trigger a Force refresh on the XBMC.org repository.

What happens if I don't like XBMC v13, can I just install XBMC v12 again?

Whilst Gotham does "upgrade" the library, it stores a Frodo compatible copy. Just replace the Gotham application with Frodo. It is still recommended to always make a backup of your userdata folder before updating, just in case. Add-ons will likely need to be reset (uninstall and then reinstall) if you go from Gotham to Frodo.

Where can I get more help?

The general and platform specific FAQs, the XBMC support forums: http://forum.kodi.tv, and/or the #xbmc IRC chat channel on irc.freenode.org.