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

HOW-TO:Install XBMC for Linux

From Kodi
Jump to: navigation, search
Home icon grey.png   ▶ Installing
▶ Linux
▶ HOW-TO:Install XBMC for Linux

These are instructions for people who already have a Linux-based OS set up. If you have not installed a Linux-based OS yet, you might wish to try out XBMCbuntu which will install both the OS and XBMC with an easy installer.


1 Official Team Kodi/XBMC repositories

1.1 Ubuntu

Simple Install Instructions
Note: Click here to find out how to use the terminal.
  • Before you run these comands type "sudo echo" into the terminal and hit Enter.
  • Then copy the area below up to sudo add...
  • Go back to the terminal, hit the middle mouse button and when it prompts hit Enter.
  • Copy the part after sudo add... and paste it to the terminal.
  • If it askes you if you want to install enter y and hit Enter
sudo apt-get install python-software-properties pkg-config
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install xbmc xbmc-bin

1.2 Repositories

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

1.3 Package maintenance FAQ

1.3.1 Why are XBMC packages from Ubuntu repositories incorrect?


The simple answer is that, these packages derive from XBMC versions which are either outdated and broken or both, and are 100% officially unsupported at this time.

The main thing you must understand is that if you looking for supported official builds, you simply should not use other repositories, unless otherwise indicated by a Team Member or a informed community member.

1.3.2 How do I find out what version I am currently using?


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

sudo apt-cache policy

Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).

1.3.3 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

1.3.4 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

1.3.5 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

1.3.6 How do I update XBMC?


To update XBMC/Kodi when a new version is released, just do a general system/package or use the following commands in the terminal (or via SSH):

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

1.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

1.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.

1.3.9 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.

1.3.10 How can I install a beta/unstable version?


To install a beta/unstable version of XBMC you must first add the unstable repository, then install XBMC:

sudo add-apt-repository ppa:team-xbmc/unstable
sudo apt-get update
sudo apt-get install xbmc

Follow the prompts to add the repository, then to add the updates, and finally install the new version of XBMC.

Note: You may need to restart your computer for the newly installed version to be working.

1.3.11 How can I move from a beta/unstable to a stable version?


Check what XBMC versions you have access to:

sudo apt-cache policy xbmc
  Installed: 2:13.2~git20140719.0900-beta2-0trusty
  Candidate: 2:13.2~git20140719.0900-beta2-0trusty
  Version table:
 *** 2:13.2~git20140719.0900-beta2-0trusty 0
        500 http://ppa.launchpad.net/team-xbmc/unstable/ubuntu/ trusty/main amd64 Packages
        100 /var/lib/dpkg/status
     2:13.1~git20140606.0917-gotham-0trusty 0
        500 http://ppa.launchpad.net/team-xbmc/ppa/ubuntu/ trusty/main amd64 Packages
     2:12.3+dfsg1-3ubuntu1 0
        500 http://us.archive.ubuntu.com/ubuntu/ trusty/universe amd64 Packages
Note: In the above example we have an unstable (team-xbmc/unstable) and the release versions (team-xbmc/ppa) available. The version with the *** is the currently installed version (unstable)

To install the release version we need to install the team-xbmc/ppa version (in the above example: "2:13.1~git20140606.0917-gotham-0trusty"). This requires us to install both the "xbmc" and the "xbmc-bin" package.

sudo apt-get install xbmc=2:13.1~git20140606.0917-gotham-0trusty xbmc-bin=2:13.1~git20140606.0917-gotham-0trusty
Note: You will get a warning you are downgrading, hit Y when asked to continue

Remove the beta/unstable repository from XBMC to clean up:

sudo add-apt-repository -r ppa:team-xbmc/unstable

1.3.12 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*

1.3.13 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.

2 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.

3 Other repositories

Unofficial Linux binaries that are un/semi supported by Team XBMC. These use internal ffmpeg libraries rather than system ffmpeg or libav, which is recommended for XBMC.

3.1 Debian


3.2 OpenELEC

OpenELEC (short for "Open Embedded Linux Entertainment Center") is a free and open source, small and very fast booting, embedded operating system. OpenELEC is a complete media center software suite that comes with a pre-configured version of XBMC and third-party add-ons with retro video game console emulators and PVR plugins.

4 Installation from source

If distribution packages are not available, or you need a newer version, or specific features enabled, then you will most likely need to compile from source. While compiling from source does not differ very much between distributions (except for installation of build dependencies), a few different guides are available in this wiki.

5 See also

Personal tools

Wiki help