Official Ubuntu PPA

From Official Kodi Wiki
Revision as of 15:29, 17 September 2014 by UNiversal (talk | contribs) (Installing, updating or upgrading)
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: ppa:team-xbmc/ppa Final release builds ppa:team-xbmc/unstable Betas and release candidates ppa:team-xbmc/xbmc-nightly Nightly builds
For the users looking for compile with the PPA build depends in addition to the nightly PPA: ppa:team-xbmc/xbmc-ppa-build-depends Build Depends

2 Package management F.A.Q.

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?


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

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

2.3 How do I find out what repositories 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 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


  • The process of adding and removing repositories is recommended when changing the repos 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.

3.6 How do I upgrade the Kodibuntu base OS?


To actually upgrade the underlying Linux which "Kodibuntu" 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 Kodi itself by treating it as a normal Linux package and update/install via: Upgrading Kodi via ppa in Kodibuntu

<syntaxhighlighter lang=bash enclose="div"> sudo apt-get update sudo apt-get install update-manager-core sudo do-release-upgrade </syntaxhighlighter>
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.

3.7 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.8 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.9 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 trusty/main amd64 Packages
        100 /var/lib/dpkg/status
     2:13.1~git20140606.0917-gotham-0trusty 0
        500 trusty/main amd64 Packages
     2:12.3+dfsg1-3ubuntu1 0
        500 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