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


(Redirected from XBMCbuntu/FAQ)
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 boot-USB drive/LiveCD image with XBMC pre-configured to work directly out-of-the-box for a dedicated set-top-box style installation of XBMC. Users can either demo XBMC without touching the internal HDD, or use it to install XBMCbuntu on the HDD, without any pre-installed operating systems. XBMCbuntu is based on a light weight version of Ubuntu.

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/
Note: XBMCbuntu v13 will not have flavours its a generic 64bit ISO

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:

  1. Boot your system with the installer thumbdrive and select the "Try Ubuntu" option. This should boot into XBMC.
  2. Click the Shutdown menu in XBMC (lower-left corner) and select "Exit"
  3. You should be presented with a log-in screen. Click "Other..." and enter xbmc as the login and select XBMCbuntu from the dropdown menu (below the Login field).
  4. Click "Login" and you will be prompted for the Password; just leave it blank.
  5. Click "Login" again and the XBMCbuntu desktop should be displayed.
  6. On the top-left corner of the desktop should be an icon to install Ubuntu. Double-click the icon and, hopefully, you'll get the installation wizard this time.

2.3 When running XBMCbuntu as a Live CD my changes are lost. Why?

  • Since a live CD is booted from read-only media, it requires either installation to rewriteable media (i.e. a USB flash drive or hard disk drive) or complete remastering to install additional software or modify the existing files.

2.4 What is the username and password to the underlying live OS environment?


The username and password to the underlying OS environment are not needed by the average users of XBMCbuntu, but here they are just in case you want to dig into the (very) advanced possibilities that are available. The default username and password on the live CD are listed below, but during installation, you will be able to change these to your own username and password. We recommend that you write down the username and password you have chosen, and store it away in a safe place;

Username: xbmc
Password: (none) 

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" Putty or a shell in Linux/OS X

See below
The XBMC repositories are as follows:
https://launchpad.net/~team-xbmc/+archive/ppa ppa:team-xbmc/ppa  Final release builds
https://launchpad.net/~team-xbmc/+archive/unstable ppa:team-xbmc/unstable Betas and release candidates
https://launchpad.net/~team-xbmc/+archive/xbmc-nightly ppa:team-xbmc/xbmc-nightly Nightly builds

For the users looking for compile with the PPA build depends in addition to the nightly PPA:

https://launchpad.net/~team-xbmc/+archive/xbmc-ppa-build-depends ppa:team-xbmc/xbmc-ppa-build-depends  Build Depends

3.2 What repositories are in my sources list?


You can get a complete listing of what repositories are part of your sources list by typing:

sudo apt-cache policy

3.3 What Version of XBMC do I currently have installed?


You can detremine the current version of XBMC you have installed, by typing:

sudo apt-cache policy xbmc

3.4 Are any dependencies required?


Some dependencies are required to add ppas into your distro via terminal, by typing:

sudo apt-get install python-software-properties pkg-config

3.5 How do I add or remove ppas?


After you determined which ppa you would like to add or remove follow the instructions below.

You can remove a ppa from your distro's sources list via terminal, by typing
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa
You can add a ppa to your distro's sources list via terminal, by typing
sudo add-apt-repository ppa:the_ppa_you_wish_to_use

3.6 How do I install XBMC?


After adding or removing any ppa you need to refresh your sources list and finally install XBMC, by typing:

sudo apt-get update
sudo apt-get install xbmc xbmc-bin

3.7 How do I upgrade XBMC?


After adding or removing any ppa you need to refresh your sources list and finally upgrade xbmc, by typing:

sudo apt-get update
sudo apt-get --only-upgrade install xbmc xbmc-bin

3.8 Why wont XBMC upgrade?


After following the above instructions, XBMC is still not upgraded, the main reason why this happens is because the distribution you are using, is no longer supported and has reached an end of life status.

See Current Ubuntu releases if your current distro is listed under End of life table, you will need to upgrade your OS to a supported release.

LTS releases are better for long term install and forget, installing obviously the very latest LTS release available.

3.9 How do I uninstall XBMC?


If you need to remove and purge an application and finally remove/purge XBMC, by typing:

sudo apt-get update
sudo apt-get remove xbmc*
sudo apt-get purge xbmc*

3.10 How to install a specific versions?


In the event you need to install either by upgrade or downgrade a specific XBMC version (a reason may be a bug or to test a specific version), the PPA providing said version active must be in your sources.list.d along with a updated list of the packages. If the packages you intend to install are on a different PPA, you should probably remove that PPA to avoid confusion. apt-get install packagename=version is one way to achieve this.

sudo apt-get update
sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty

Hint: For e.g. You can use result of apt-cache policy xbmc to see the candidates <packagename><version> available to you.

Note: Removing/purging any previous versions if they are greater version of the package you are looking to install is necessary.

3.11 What are PPA build dependencies?


These build dependencies are versions of a library pre-packaged by Team XBMC, because the distro provided versions are behind the current requirements of XBMC. Both REAME.linux and/or README.ubuntu documents using XBMC ppa build dependencies refer to these dependencies in the Team XBMC PPA's used in conjunction, when compiling on Ubuntu or derivatives distros.

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

9 Known issues

See: XBMC v12 (Frodo) issues

Personal tools

Wiki help