Official Kodi Wiki - User contributions [en]

HOW-TO:Install Kodi for Linux

2016-04-27T06:40:53Z

Mikaabra: Changed the wording to on the Ubuntu Kodi warning to say that not only 16.04 includes Ubuntu Kodi.

{{mininav|[[Linux]] {{l2| [[Installation]] }} }}
== Installing Kodi on Ubuntu-based distributions ==
{{warning|Some (later) Ubuntu versions include Kodi built by Ubuntu themselves. If you have installed Ubuntu Kodi, please remove the packages "kodi kodi-bin kodi-data" before trying to install team-xbmc PPA packages.}}

See [[SSH]] or [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 binary add-ons (PVR, audio decoders, audio encoders, screensavers, visualizations, audio DSP) ===
{{see|Ubuntu binary add-ons}}

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

Note that if you have any addons (such as PVR clients), these must be updated as well (they will not be updated automatically):
<syntaxhighlight lang="bash">
sudo apt-get install kodi-pvr-mythtv
</syntaxhighlight>

=== Upgrading ===
<section begin="Ubuntu upgrade" />
To update 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>

{{note|In some cases where additional packages are required, Kodi will fail to upgrade when using the upgrade commands as above. To install additional packages use the command below:

<syntaxhighlight lang="bash">
sudo apt-get dist-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 kodi-bin
sudo apt-get install kodi
</syntaxhighlight>

=== Downgrading between newer and older stable versions ===
{{incomplete}}

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

The installation if you are using Debian (Jessie), you can use the debian-backports repository.

Add the following lines to your /etc/apt/sources.list file, as superuser (sudo)

<syntaxhighlight lang="bash">
# kodi repos
# starting with debian jessie, debian provides kodi via its backports repository
# remember: those packages are not supported by team kodi
deb http://http.debian.net/debian jessie-backports main
</syntaxhighlight>

And then, update APT and install Kodi.

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

Enjoy your new Kodi.

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

=== 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]]
*[[JeOS implementations for Kodi]]

* [[Linux FAQ]]

{{Updated|16}}

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

HOW-TO:Install Kodi for Linux

2016-04-25T11:37:42Z

Mikaabra: Changed the ubuntu 16.04 warning to reflect issues with team-xbmc Kodi v16.1 PPAs conflict with ubuntu included Kodi v15.2 and how to resolve this.

{{mininav|[[Linux]] {{l2| [[Installation]] }} }}
== Installing Kodi on Ubuntu-based distributions ==
{{Expire | 20160430 | {{warning|Ubuntu 16.04 includes Kodi v15.2. If you have installed Ubuntu Kodi, please remove the packages "kodi kodi-bin kodi-data" before trying to install team-xbmc PPA packages.}} }}

See [[SSH]] or [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 binary add-ons (PVR, audio decoders, audio encoders, screensavers, visualizations, audio DSP) ===
{{see|Ubuntu binary add-ons}}

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

Note that if you have any addons (such as PVR clients), these must be updated as well (they will not be updated automatically):
<syntaxhighlight lang="bash">
sudo apt-get install kodi-pvr-mythtv
</syntaxhighlight>

=== Upgrading ===
<section begin="Ubuntu upgrade" />
To update 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>

{{note|In some cases where additional packages are required, Kodi will fail to upgrade when using the upgrade commands as above. To install additional packages use the command below:

<syntaxhighlight lang="bash">
sudo apt-get dist-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 kodi-bin
sudo apt-get install kodi
</syntaxhighlight>

=== Downgrading between newer and older stable versions ===
{{incomplete}}

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

The installation if you are using Debian (Jessie), you can use the debian-backports repository.

Add the following lines to your /etc/apt/sources.list file, as superuser (sudo)

<syntaxhighlight lang="bash">
# kodi repos
# starting with debian jessie, debian provides kodi via its backports repository
# remember: those packages are not supported by team kodi
deb http://http.debian.net/debian jessie-backports main
</syntaxhighlight>

And then, update APT and install Kodi.

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

Enjoy your new Kodi.

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

=== 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]]
*[[JeOS implementations for Kodi]]

* [[Linux FAQ]]

{{Updated|16}}

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

HOW-TO:Install Kodi for Linux

2016-04-23T03:52:34Z

Mikaabra: Updated with warning for users that ubuntu 16.04 currently isn't working.

{{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 ==
See [[SSH]] or [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.

'''(Please note that that at time of writing (23 April 2016), Ubuntu 16.04 team-xbmc repositories are not working and you'd have to use Kodi 15.2 included with Ubuntu 16.04).'''

<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 ===
{{see|Ubuntu PVR add-ons}}

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

Note that if you have any addons (such as PVR clients), these must be updated as well (they will not be updated automatically):
<syntaxhighlight lang="bash">
sudo apt-get install kodi-pvr-mythtv
</syntaxhighlight>

=== Upgrading ===
<section begin="Ubuntu upgrade" />
To update 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>

{{note|In some cases where additional packages are required, Kodi will fail to upgrade when using the upgrade commands as above. To install additional packages use the command below:

<syntaxhighlight lang="bash">
sudo apt-get dist-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 kodi-bin
sudo apt-get install kodi
</syntaxhighlight>

=== Downgrading between stable versions ===
{{incomplete}}

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

The installation if you are using Debian (Jessie), you can use the debian-backports repository.

Add the following lines to your /etc/apt/sources.list file, as superuser (sudo)

<syntaxhighlight lang="bash">
# kodi repos
# starting with debian jessie, debian provides kodi via its backports repository
# remember: those packages are not supported by team kodi
deb http://http.debian.net/debian jessie-backports main
</syntaxhighlight>

And then, update APT and install Kodi.

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

Enjoy your new Kodi.

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

== 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]]
*[[JeOS implementations for Kodi]]

* [[Linux FAQ]]

{{Helix updated}}

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