21 Aug 2020 - The wiki is undergoing a major cleanup. If you arrived here from a search engine and cannot find the page, please use the wiki search instead (top right corner of page)
More info can be found on the forum

Official Ubuntu PPA

From Official Kodi Wiki
Revision as of 19:36, 17 September 2014 by UNiversal (talk | contribs) (Package management F.A.Q.)
Jump to: navigation, search

Personal Package Archives, or PPAs are software repositories that hold compiled version of software, primarily for Ubuntu and various Ubuntu derivatives (such as Lubuntu, non-Debian versions of Linux Mint, XBMCbuntu, and many others).

The Team XBMC PPA provides the only officially supported pre-compiled binaries for Ubuntu and Ubuntu-based systems.

NOTICE All users should use the Team XBMC PPA instead of the system repositories (or any build that uses external ffmpeg/libav) for proper support and best running operation.

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

2 Package management F.A.Q.

Here we give detailed information on Advanced Packaging Tool, a.k.a. APT. and the necessary commands to retrieve, install, update, upgrade and or remove the application also known as XBMC or Kodi on Ubuntu and variants such as XBMCbuntu/KodiBuntu. Such information is widespread on any Ubuntu documentation and is duplicated here for simplicity and general user base benefit.

2.1 Why are XBMC packages from Ubuntu repositories incorrect?


The simple answer is that, these packages derive from externally modified 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.

2.2 Are any dependencies required to manage repo's or ppa's?


Some dependencies are required to manage ppa's/repos within your distro, install these by typing:

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

2.3 How do I find out what repo/ppa 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

2.4 How do I add or remove ppa's?


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


  • The process of adding and removing repositories is recommended when changing the repo's in use.
  • Changing the PPA repo for XBMC will change what type of install is used (stable, nightly, beta, etc).

3 Installing, updating or upgrading

If applicable you can check what package versions are installed in your system, this is helpful when determining what procedures to choose.

3.1 How can check what current XBMC version is installed?


Check what XBMC versions you have access to:

sudo apt-cache policy xbmc

3.2 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.3 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

3.4 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.5 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. XBMCbuntu FAQ

3.6 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.7 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 xbmc-bin
sudo add-apt-repository ppa:team-xbmc/nightly
sudo apt-get update
sudo apt-get install xbmc xbmc-bin

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.

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


Check what XBMC versions you have access to by typing:

sudo apt-cache policy xbmc

The response in terminal should be something like:

  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 the install of 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

4 Uninstalling or Removing

4.1 How do I uninstall XBMC?


If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by typing:

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

5 Build Dependencies

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

6 See also