HOW-TO:Install Kodi for Linux

2015-02-20T14:15:22Z

Rovanion: /* Installing Kodi on Ubuntu-based distributions */ Only software-properties-common is needed

{{Kodi migration note}}

= Official Team Kodi repositories =

The installation instructions within this section reference repositories that are officially sanctioned by Team Kodi. For third party and unofficial build support, please see the section below.

== Installing Kodi on Ubuntu-based distributions ==
{{note|1=[http://help.ubuntu.com/community/UsingTheTerminal Click here to find out how to use the terminal.]}}

Use the command line terminal and enter the following commands. Follow the prompts as you would any other software installation.

<syntaxhighlight lang="bash">
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi
</syntaxhighlight>

{{#lst:Team XBMC PPA|repos}}

=== Installing PVR Addons ===
The Linux release of Kodi doesn't include any PVR addons by default. To install a PVR addon, run the following command and replace the XXXXXX with the PVR addon of your choice:

<syntaxhighlight lang="bash">
sudo apt-get install kodi-pvr-XXXXXXX
</syntaxhighlight>

{| class="wikitable"
|-
! PVR Addon !! Description
|-
| kodi-pvr-dev || Kodi Media Center (PVR Add-on Dev package)
|-
| kodi-pvr-argustv || Kodi PVR Addon Argustv
|-
| kodi-pvr-demo || Kodi PVR Demo Addon
|-
| kodi-pvr-dvbviewer || Kodi PVR Addon Dvbviewer
|-
| kodi-pvr-iptvsimple || Kodi PVR Iptv Addon
|-
| kodi-pvr-mediaportal-tvserver || Kodi PVR Addon Mediaportal Tvserver
|-
| kodi-pvr-mythtv || Kodi PVR Addon MythTv - Cmyth
|-
| kodi-pvr-nextpvr || Kodi PVR Addon NextPvr
|-
| kodi-pvr-njoy || Kodi PVR Addon Njoy
|-
| kodi-pvr-tvheadend-hts || Kodi PVR Addon TvHeadend Hts
|-
| kodi-pvr-vdr-vnsi || Kodi PVR Addon VDR Vnsi
|-
| kodi-pvr-vuplus || Kodi PVR Addon Vuplus
|}

=== Installing a development build ===
{{see also|Development builds}}
To install a beta/unstable version of {{kodi}} you must first add the unstable repository, then install XBMC. Use <code>ppa:team-xbmc/xbmc-nightly</code> for nightly builds and <code>ppa:team-xbmc/unstable</code> for [[beta]] builds.

<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:team-xbmc/xbmc-nightly
sudo apt-get update
sudo apt-get install kodi
</syntaxhighlight>

=== Upgrading ===
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]]):

<syntaxhighlight lang="bash">
sudo apt-get update
sudo apt-get upgrade
</syntaxhighlight>
<section end="Ubuntu upgrade" />

=== Downgrading to a stable version from a development version ===
If you install a nightly build or an unstable release and want to return to a stable release, follow these instructions:

Find the current PPA you are using:
<syntaxhighlight lang="bash">
sudo apt-cache policy | grep team-xbmc
</syntaxhighlight>

Remove the unstable or nightly PPA where it says '''PPAHERE''':
<syntaxhighlight lang="bash">
sudo add-apt-repository -r ppa:PPAHERE
</syntaxhighlight>

Then restore the stable version with the following commands:
<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get remove kodi
sudo apt-get install kodi
</syntaxhighlight>

=== Downgrading to a stable version from a development version ===
{{note|If you have existing settings then they probably won't migrate well to the older version. Especially add-ons and library data. It is recommended that you start fresh ''(delete the [[userdata folder]] and parent .kodi/.xbmc folder)'' or restore from a [[backup]] that works with the older version you are installing.}}

Use these commands if you need to downgrade from a stable version to another stable version. For example, to downgrade from Kodi v14 to XBMC v13.2:

<syntaxhighlight lang="bash" enclose="div">
sudo apt-get update
sudo apt-get install xbmc=2:13.2* xbmc-bin=2:13.2*
</syntaxhighlight>

Note the version number after "<code>xbmc=2:</code>". For older Kodi versions replace "xbmc" with "kodi" for both <code>xbmc</code> and <code>xbmc-bin</code>.

For a full list of available versions type in this command:
<syntaxhighlight lang="bash" enclose="div">
sudo apt-cache policy xbmc
</syntaxhighlight>

or

<syntaxhighlight lang="bash" enclose="div">
sudo apt-cache policy kodi
</syntaxhighlight>

=== Uninstalling ===
If you need to remove and purge an application and finally removing/purging also the application configurations files, do so by using the following commands:

<syntaxhighlight lang="bash" enclose="div">
sudo apt-get update
sudo apt-get remove kodi*
sudo apt-get purge kodi*
</syntaxhighlight>

Then remove the settings folder to remove all settings and library data. This will not delete any videos or music, but just the settings and library data itself:
<syntaxhighlight lang="bash">
rm ~/.kodi/
</syntaxhighlight>
or
<syntaxhighlight lang="bash" enclose="div">
rm ~/.xbmc/ # for older versions before 14.0
</syntaxhighlight>

= Third Party Repositories =


The instructions in this section are for unofficial Linux binaries that are un/semi supported by Team Kodi. Most of those binaries use system ffmpeg or even worse totally untested libav, which is not recommended for {{kodi}} as we support ffmpeg only.

== Debian ==
http://people.debian.org/~rbalint/ppa/xbmc-ffmpeg/

== Fedora ==
Refer to [[HOW-TO:Install Kodi on Fedora 21 using RPMFusion packages]] for a guide showing how to install Fedora 21 and Kodi to create a quick-booting, standalone style of media player.

FedoraProject also has [http://fedoraproject.org/wiki/HTPC this page] discussing how to build a dedicated home theatre.

== OpenELEC ==
{{main|OpenELEC}}
{{#lst:OpenELEC|intro}}

== KodiBuntu ==
The installation instructions on this page are intended for people who already have a Linux-based OS setup, or wish to do their own installation of Linux. Alternatively you can try out [[KodiBuntu]], which will install both an OS and {{kodi}} with an easy installer.

{{main|KodiBuntu}}
{{#lst:KodiBuntu|intro}}

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

* [[HOW-TO compile XBMC for Linux from source code]]
* [[HOW-TO compile XBMC for Linux on Debian/Ubuntu]] - This is a tutorial on how to compile and install {{kodi}} on Debian and Ubuntu.

= See also =
* [[Linux]]
* [[HOW-TO:Autostart XBMC for Linux]]

* [[Linux FAQ]]

{{Helix updated}}

[[Category:Linux]]
[[Category:How-to]]
[[Category:Installation|Linux]]
[[Category:Manual]]

Official Kodi Wiki - User contributions [en]

HOW-TO:Install Kodi for Linux