XBMC will be renamed to Kodi for v14. Read here for more details


From Kodi
Jump to: navigation, search
Home icon grey.png   ▶ XBMCbuntu ▶ XBMCbuntu FAQ

Frequently Asked Questions for XBMCbuntu


1 General FAQ

See also: XBMC all platforms FAQ for FAQs that apply to all versions of XBMC.
See also: XBMC v13 (Gotham) FAQ for FAQs related to the (Gotham) v13 release.

1.1 What is XBMCbuntu?


XBMCbuntu is a combination XBMC/operating system for use on PCs that are mainly just running XBMC. It is an alternative to installing Windows or a larger (and sometimes more complicated) Linux-based OS.

1.2 What is the XBMCbuntu.iso?

The XBMCbuntu .iso is a Lubuntu based Linux distro, customised to provide point releases of XBMC like v13 Gotham. can also be used to create a bootable USB disk.
Because of the nature of Live facilities of Linux distros available in XBMCbuntu, you can also try-it-out without installing, thus not requiring any modifications to the host harddrive.

1.3 What version of Lubuntu is used by the current XBMCbuntu?

For Gotham v13, the XBMCbuntu is based on Lubuntu 14.04LTS (Trusty Tahr)

1.4 What are XBMCbuntu's minimum and recommended requirements?

Minimum requirements are the minimum to operate Linux and XBMC, though for better results the recommended or better is suggested.

2 Installation

2.1 How do I get and install XBMCbuntu?

Download from http://xbmc.org/download/
  • Unlike XBMCbuntu v12, v13 has only one image file for all x86 computers, regardless of GPU.
  • Currently, only a 64-bit version is available, but this should cover the vast majority of users.

XBMCbuntu comes in an ISO form that can be burned to an optical disc. It can also be formatted to a USB drive, as mentioned in the next section.

For instructions on how to acquire, create a bootable usb flash drive, boot or install to/from

See: Create and install from/to a bootable USB flash drive

2.2 How do I resolve any install wizard's problems?


In the event, the XBMCbuntu install wizard isn't working for you, when selecting install from the grub menu options, do the following:

3 Upgrading

3.1 How do I upgrade XBMC from PPA in XBMCBuntu?


You dont have to necessarily wipe your current install to try a new version of XBMC, like a nightly version or beta for example, you can just "fire up" SSH Putty or a shell in Linux/OS X

See Team KODI PPA for complete upgrade instructions

4 Drivers

4.1 How can I Upgrade NVidia drivers in Ubuntu/XBMCbuntu and variants?


Nvidia as well as drivers suppliers for Ubuntu and variants, recommended user to install these packages via repositories provided! The maintainers ensure the drivers are correct and compatible to the distro being targeted.

sudo apt-get install python-software-properties pkg-config
sudo add-apt-repository ppa:ubuntu-x-swat/x-updates
sudo apt-get update
sudo apt-get install nvidia-current nvidia-settings

Attention talk.png Nvidia Drivers updates XBMCBuntu.Ubuntu and variants forum discussion thread

5 Handling files & Backups

5.1 How can I transfer files to/from XBMCbuntu?


Use SFTP with a client such as Cyberduck or FileZilla or scp via SSH within Linux/OS X shell. username and password is xbmc blank or the xbmc password selected during install.

See also: Connecting to XBMCbuntu via SFTP
See also: Connecting to XBMCbuntu via SSH

5.2 How can I backup all my settings to restore them if something goes wrong?


You can use the Add-on:XBMC Backup Backup and restore your XBMC database and configuration files in the event of a crash or file corruption.

Alternatively if you do not wish to use a addon, you can navigate to your userdata folder and copy/archive all its contents to a external drive. This can be achieved various ways, depending on your OS.

6 Connectivity

6.1 How can I connect a bluetooth keyboard/mouse/remote??


A good way to decipher this is to:

See this video:http://lubuntu.net/blog/lubuntu-screencast-bluetooth

7 Troubleshooting

7.1 What if I have audio issues with XBMCbuntu?


You can look at the audio troubleshooting page below, if your problems persist, you can always try to search for answers to your problem in forums and if none are found open your own thread. Remember to have Debug log handy in pastebin, in such cases.

See: Audio Troubleshooting

7.2 Can't install, because the install window is too big?


In the event you come across this issue, you can look at adapting the solutions proposed in the forum post below.

See Can't install because the install window is too big?

7.3 Can't install because the text is too small?


In the event you come across this issue, you can look at adapting the solutions proposed in the forum post below.

See Can't install because the text is too small?

8 Upgrading XBMCbuntu

8.1 How do I upgrade the XBMCbuntu base OS?


To actually upgrade the underlying Linux which "XBMCbuntu" is based on, it is possible to do so via release upgrade.

There are advantages and disadvantages to doing so. It's not a method recommended lightly to inexperienced users, doing so means you understand and accept responsibility for breaking your system.

BACKUP! Never attempt any upgrades without having proper backups of the files you consider important or value or have a full system image/backup of working system you can restore.
RECOMMENDED! It is possible (in order to preserve systems tweaks) to just upgrade XBMC itself by treating it as a normal Linux package and update/install via: Upgrading XBMC via ppa in XBMCbuntu

sudo apt-get update
sudo apt-get install update-manager-core
sudo apt-get do-release-upgrade

This should upgrade your Base distribution, however if your current version is too old it may require repeating these steps until you reach the desired version. Do note that this is not recommended to inexperienced Linux users in case of breakages that you wont be able to resolve.

9 Known issues

See: Common_issues

Personal tools

Wiki help