HOW-TO:Install Kodi for Linux: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
(Updated with warning for users that ubuntu 16.04 currently isn't working.)
m (syntaxhighlight fix)
(35 intermediate revisions by 9 users not shown)
Line 1: Line 1:
{{Kodi migration note}}
{{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.}}
= 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.]
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.
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>
 
<syntaxhighlight lang="bash">
sudo apt-get install software-properties-common
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo add-apt-repository ppa:team-xbmc/ppa
Line 22: Line 16:
{{#lst:Team XBMC PPA|repos}}
{{#lst:Team XBMC PPA|repos}}


=== Installing PVR Addons ===
Note that this PPA only provides builds for Ubuntu i386 and Ubuntu amd64 but not for Ubuntu armhf, which can run on a Raspberry Pi.
{{see|Ubuntu PVR add-ons}}
 
=== Installing binary add-ons (PVR, audio decoders, audio encoders, screensavers, visualizations, audio DSP) ===
{{see|Ubuntu binary add-ons}}


=== Installing a development build ===
=== Installing a development build ===
Line 29: Line 25:
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.
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">
<syntaxhighlight lang=bash>
sudo add-apt-repository ppa:team-xbmc/xbmc-nightly
sudo add-apt-repository ppa:team-xbmc/xbmc-nightly
sudo apt-get update
sudo apt-get update
Line 36: Line 32:


Note that if you have any addons (such as PVR clients), these must be updated as well (they will not be updated automatically):
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">
<syntaxhighlight lang=bash>
sudo apt-get install kodi-pvr-mythtv
sudo apt-get install kodi-pvr-mythtv
</syntaxhighlight>
</syntaxhighlight>
Line 44: Line 40:
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]]):
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">
<syntaxhighlight lang=bash>
sudo apt-get update
sudo apt-get update
sudo apt-get upgrade
sudo apt-get upgrade
Line 52: Line 48:
{{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:
{{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">
<syntaxhighlight lang=bash>
sudo apt-get dist-upgrade
sudo apt-get dist-upgrade
</syntaxhighlight>}}
</syntaxhighlight>}}
Line 62: Line 58:


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


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


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


=== Downgrading between stable versions ===
=== Downgrading between newer and older stable versions ===
{{incomplete}}
If you want to return to the previous stable release, follow these instructions:
 
Remove the current stable PPA:
<syntaxhighlight lang=bash>
sudo add-apt-repository -r ppa:team-xbmc/ppa
</syntaxhighlight>
 
Then install the old stable version with the following commands:
<syntaxhighlight lang=bash>
sudo add-apt-repository ppa:team-xbmc/kodi-old
sudo apt-get update
sudo apt-get remove kodi*
sudo apt-get install kodi
</syntaxhighlight>
 
=== Reverting to an earlier nightly ===
ALthough launchpad doesn't list older nightlies in their PPA, they are usually still available for download directly from the website.
Visit https://launchpad.net/~team-xbmc/+archive/ubuntu/xbmc-nightly/+packages?field.name_filter=&field.status_filter=superseded&field.series_filter=
 
You will then have to download the appropiate .deb file and manually install it.


=== Uninstalling ===
=== 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:
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">
<syntaxhighlight lang=bash enclose="div">
sudo apt-get update
sudo apt-get update
sudo apt-get remove kodi*
sudo apt-get remove kodi*
Line 92: Line 107:


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:
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">
<syntaxhighlight lang=bash>
rm ~/.kodi/  
rm -r ~/.kodi/  
</syntaxhighlight>
</syntaxhighlight>
or
or
<syntaxhighlight lang="bash" enclose="div">
<syntaxhighlight lang=bash enclose="div">
rm ~/.xbmc/ # for older versions before 14.0
rm -r ~/.xbmc/ # for older versions before 14.0
</syntaxhighlight>
</syntaxhighlight>


= Third Party Repositories =
== Embedded/Appliance type install==
 
=== LibreELEC ===
{{main|LibreELEC}}
{{#lst:LibreELEC|intro}}
 
== Third Party Repositories ==
<!-- Please only list repos that use an internal ffmpeg library -->
<!-- Please only list repos that use an internal ffmpeg library -->


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.
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.
=== Debian ===
In Debian 9 (Stretch), Kodi is available in the default "main" Debian repository (you can check this with 'apt-cache show kodi' to show the description or 'apt-cache policy kodi' to check installed/available version).
 
In Debian 9 (Stretch), update APT and install:
<syntaxhighlight lang=bash>
sudo apt-get update
sudo apt-get install kodi
</syntaxhighlight>
 
 
For installation if you are using Debian 8 (Jessie), you can use the debian-backports repository.


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


<syntaxhighlight lang="bash">
<syntaxhighlight lang=bash>
# kodi repos
# kodi repos
# starting with debian jessie, debian provides kodi via its backports repository
# starting with debian jessie, debian provides kodi via its backports repository
Line 120: Line 150:
And then, update APT and install Kodi.
And then, update APT and install Kodi.


<syntaxhighlight lang="bash">
<syntaxhighlight lang=bash>
sudo apt-get update
sudo apt-get update
sudo apt-get install kodi
sudo apt-get install kodi
Line 127: Line 157:
Enjoy your new Kodi.
Enjoy your new Kodi.


== Fedora ==
=== 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.
Refer to [[HOW-TO:Install Kodi on Fedora 26 using RPMFusion packages]] for a guide showing how to install Fedora 26 and Kodi to create a quick-booting, standalone style of media player.
 
=== Raspbian ===
{{see also|HOW-TO:Install Kodi on Raspberry Pi}}
Installing on Raspbian is done with:


== OpenELEC ==
<syntaxhighlight lang=bash>
{{main|OpenELEC}}
sudo apt-get install kodi
{{#lst:OpenELEC|intro}}
</syntaxhighlight>


== KodiBuntu ==
Upgrading on Raspbian is done with:
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}}
<syntaxhighlight lang=bash>
{{#lst:KodiBuntu|intro}}
sudo apt-get update
sudo apt-get upgrade
</syntaxhighlight>


= Installation from source =
== 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.
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 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.
* [[HOW-TO compile XBMC for Linux on Debian/Ubuntu]] - This is a tutorial on how to compile and install {{kodi}} on Debian and Ubuntu.
* [[HOW-TO compile Kodi for Linux on Arch/Manjaro]] - This is a tutorial on how to compile and install {{kodi}} on Arch or Manjaro linux.


= See also =
== See also ==
* [[Linux]]
* [[Linux]]
* [[HOW-TO:Autostart XBMC for Linux]]
* [[HOW-TO:Autostart XBMC for Linux]]
Line 153: Line 189:
* [[Linux FAQ]]
* [[Linux FAQ]]


{{Helix updated}}
{{Updated|17}}


[[Category:Linux]]
[[Category:Linux]]

Revision as of 12:47, 10 July 2018

Home icon grey.png   ▶ Linux
▶ Installation
▶ HOW-TO:Install Kodi for Linux

Installing Kodi on Ubuntu-based distributions

Stop hand.png 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 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.

sudo apt-get install software-properties-common
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get install kodi

Team XBMC PPA

Note that this PPA only provides builds for Ubuntu i386 and Ubuntu amd64 but not for Ubuntu armhf, which can run on a Raspberry Pi.

Installing binary add-ons (PVR, audio decoders, audio encoders, screensavers, visualizations, audio DSP)

See: Ubuntu binary add-ons

Installing a development build

To install a beta/unstable version of Kodi you must first add the unstable repository, then install XBMC. Use ppa:team-xbmc/xbmc-nightly for nightly builds and ppa:team-xbmc/unstable for beta builds.

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

Note that if you have any addons (such as PVR clients), these must be updated as well (they will not be updated automatically):

sudo apt-get install kodi-pvr-mythtv

Upgrading

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):

sudo apt-get update
sudo apt-get upgrade


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:

sudo apt-get dist-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:

sudo apt-cache policy | grep team-xbmc

Remove the unstable or nightly PPA where it says PPAHERE:

sudo add-apt-repository -r ppa:PPAHERE

Then restore the stable version with the following commands:

sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get remove kodi kodi-bin
sudo apt-get install kodi

Downgrading between newer and older stable versions

If you want to return to the previous stable release, follow these instructions:

Remove the current stable PPA:

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

Then install the old stable version with the following commands:

sudo add-apt-repository ppa:team-xbmc/kodi-old
sudo apt-get update
sudo apt-get remove kodi*
sudo apt-get install kodi

Reverting to an earlier nightly

ALthough launchpad doesn't list older nightlies in their PPA, they are usually still available for download directly from the website. Visit https://launchpad.net/~team-xbmc/+archive/ubuntu/xbmc-nightly/+packages?field.name_filter=&field.status_filter=superseded&field.series_filter=

You will then have to download the appropiate .deb file and manually install it.

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:

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

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:

rm -r ~/.kodi/

or

rm -r ~/.xbmc/ # for older versions before 14.0

Embedded/Appliance type install

LibreELEC

LibreELEC (short for "Libre Embedded Linux Entertainment Center") is small and very fast booting, open source JeOS (Just enough Operating System). LibreELEC is a complete media center software suite for embedded systems and computers, as it comes with a pre-configured version of Kodi and optional third-party PVR backend software.

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

In Debian 9 (Stretch), Kodi is available in the default "main" Debian repository (you can check this with 'apt-cache show kodi' to show the description or 'apt-cache policy kodi' to check installed/available version).

In Debian 9 (Stretch), update APT and install:

sudo apt-get update
sudo apt-get install kodi


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

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

# 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

And then, update APT and install Kodi.

sudo apt-get update
sudo apt-get install kodi

Enjoy your new Kodi.

Fedora

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

Raspbian

Installing on Raspbian is done with:

sudo apt-get install kodi

Upgrading on Raspbian is done with:

sudo apt-get update
sudo apt-get upgrade

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.

See also