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

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
(Update shell invocations to reflect current best practices for elevated apt processes)
(42 intermediate revisions by 11 users not shown)
Line 1: Line 1:
== Installing Kodi on Ubuntu-based distributions ==
{{Mininav|[[Linux]] {{L2| [[Installing]] }} }}
{{Expire | 20160430 | {{warning|Ubuntu 16.04 might have issues with the Team Kodi PPA. This will be fixed in about a week.}} }}


See [[SSH]] or [http://help.ubuntu.com/community/UsingTheTerminal Click here to find out how to use the terminal.]
== Installing Kodi on Debian-based distributions ==
{{Warning|Debian and Ubuntu versions 9 ("Stretch") and 16.04 LTS ("Xenial") or later, respectively, include their own Kodi builds in their official package repositories, customized to satisfy their interpretations of what is acceptable under their open-source mandates. If you have installed your distribution's Kodi packages, please purge them using the command <syntaxhighlight lang="shell" inline>sudo apt purge kodi*</syntaxhighlight> before trying to install team-xbmc PPA packages.}}
 
See [[SFTP]] 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.


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


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


=== Installing PVR add-ons ===
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 audio encoder add-ons ===
=== Installing binary add-ons (PVR, audio decoders, audio encoders, screensavers, visualizations, audio DSP) ===
{{see|Ripping CDs#Adding audio encoders for Ubuntu}}
{{See|Ubuntu binary add-ons}}
 
=== Installing audio DSP add-ons ===
{{see|Audio DSP#Installing ADSP add-ons on Ubuntu}}


=== Installing a development build ===
=== Installing a development build ===
{{see also|Development builds}}
{{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.
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 [[Development_builds|beta]] builds.


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


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="shell">
sudo apt-get install kodi-pvr-mythtv
sudo apt install kodi-pvr-mythtv
</syntaxhighlight>
</syntaxhighlight>


=== Upgrading ===
=== Upgrading ===
<section begin="Ubuntu upgrade" />
<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]]):
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 [[SFTP]]):


<syntaxhighlight lang="bash">
<syntaxhighlight lang="shell">
sudo apt-get update
sudo apt update
sudo apt-get upgrade
sudo apt upgrade --with-new-pkgs
</syntaxhighlight>
</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" />
<section end="Ubuntu upgrade" />


=== Downgrading to a stable version from a development version ===
=== 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:
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:
Remove the unstable or nightly PPA:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="shell">
sudo apt-cache policy | grep team-xbmc
apt-cache policy | grep -Eo 'team-xbmc/(unstable|nightly)' | sudo xargs -r add-apt-repository -ryP
</syntaxhighlight>
 
Remove the unstable or nightly PPA where it says '''PPAHERE''':
<syntaxhighlight lang="bash">
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="shell">
sudo add-apt-repository ppa:team-xbmc/ppa
sudo add-apt-repository ppa:team-xbmc/ppa
sudo apt-get update
sudo apt-get update
sudo apt-get remove kodi kodi-bin
sudo apt-get remove kodi kodi-x11
sudo apt-get install kodi
sudo apt-get install kodi
</syntaxhighlight>
</syntaxhighlight>


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


=== Uninstalling ===
=== Downgrading between newer and older stable versions ===
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 want to return to the next most recent stable release, follow these instructions:


<syntaxhighlight lang="bash" enclose="div">
Remove the current stable packages and PPA:
sudo apt-get update
<syntaxhighlight lang="shell">
sudo apt-get remove kodi*
sudo apt purge kodi*
sudo apt-get purge kodi*
sudo add-apt-repository -rP team-xbmc/ppa
</syntaxhighlight>
</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:
Then install the "oldstable" version with the following commands:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="shell">
rm ~/.kodi/
sudo add-apt-repository -ysP team-xbmc/kodi-old
sudo apt install kodi
</syntaxhighlight>
</syntaxhighlight>
or
 
<syntaxhighlight lang="bash" enclose="div">
=== Reverting to an earlier nightly ===
rm ~/.xbmc/ # for older versions before 14.0
ALthough launchpad doesn't list older nightlies in their PPA, they are usually still available for download directly from the website. Visit the [https://launchpad.net/~team-xbmc/+archive/ubuntu/xbmc-nightly/+packages?field.name_filter=&field.status_filter=superseded&field.series_filter= xbmc-nightly repository index], where you will then have to download the appropriate .deb files and manually install them using <code>sudo dpkg -i [path to downloaded file]</code>.
 
=== Uninstalling ===
If you need to uninstall Kodi and purge its global configuration files (for instance, in the attempt to troubleshoot a persistent crash or other errors), do so by using the first of the following commands. If that fails to solve the issue, you will likely need to remove your user settings folder with all of your settings and library data to return to a state equivalent to what existed before Kodi was first installed on the system. This will not delete any videos or music, but just the settings and library data itself, but it is still recommended to keep a backup of them in case it's discovered that they weren't at issue and you are able to effect another solution. An example of how to accomplish a backup and then deletion of your user settings is provided on the last two lines, the highlighted one being responsible for making the backup which can thereafter be found in your home folder with the filename kodi-backup_''timestamp''.tar.xz.
 
<syntaxhighlight lang="shell" highlight="2-3">
sudo apt purge kodi*
tar cf - "${HOME}/.kodi/" | xz -z9e - >"${HOME}/kodi-backup_$(date +%m%d%y-%H%M).tar.xz"
rm -Ri "${HOME}/.{kodi,xbmc}/"
</syntaxhighlight>
</syntaxhighlight>
== Embedded/Appliance type install==
=== LibreELEC ===
{{main|LibreELEC}}
{{#lst:LibreELEC|intro}}


== Third Party Repositories ==
== Third Party Repositories ==
Line 103: Line 102:


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 ===
=== Debian ===
In Debian 9 (Stretch) and 10 (Buster), Kodi is available in the default "main" Debian repository. You can check this with 'apt show kodi' to show the description or 'apt policy kodi' to check available version and whether it's installed. The version in the Debian main repository is an older version (built by Debian) and is not maintained by the Kodi team.
In Debian 9 and 10, update APT and install:
<syntaxhighlight lang=bash>
sudo apt update
sudo apt install kodi
</syntaxhighlight>


The installation if you are using Debian (Jessie), you can use the debian-backports repository.
 
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 119: Line 127:
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
</syntaxhighlight>
</syntaxhighlight>


Enjoy your new Kodi.


=== Fedora ===
=== Raspbian ===
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.
{{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>
 
Upgrading on Raspbian is done with:
 
<syntaxhighlight lang=bash>
sudo apt-get update
sudo apt-get upgrade
</syntaxhighlight>


=== 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 ==
== 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. See our '''[[Compiling Kodi]]''' guide.
 
* [[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]]
<!--{{mininav| [[Installing]] {{l2| [[Linux]] }} }}-->
* [[Linux FAQ]]


{{Updated|16}}
{{Updated|19}}


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

Revision as of 04:44, 1 May 2021

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

Installing Kodi on Debian-based distributions

Stop hand.png Debian and Ubuntu versions 9 ("Stretch") and 16.04 LTS ("Xenial") or later, respectively, include their own Kodi builds in their official package repositories, customized to satisfy their interpretations of what is acceptable under their open-source mandates. If you have installed your distribution's Kodi packages, please purge them using the command sudo apt purge kodi* before trying to install team-xbmc PPA packages.


See SFTP 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 install software-properties-common
sudo add-apt-repository -ysP team-xbmc/ppa
sudo apt install kodi


The Kodi repositories are as follows:

Note: Although the URL still has "Team XBMC" in the title, these are the current URLs for Kodi.

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

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 apt install software-properties-common
sudo add-apt-repository -ysP team-xbmc/xbmc-nightly
sudo apt 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 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 SFTP):

sudo apt update
sudo apt upgrade --with-new-pkgs


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:

Remove the unstable or nightly PPA:

apt-cache policy | grep -Eo 'team-xbmc/(unstable|nightly)' | sudo xargs -r add-apt-repository -ryP

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-x11
sudo apt-get install kodi


Downgrading between newer and older stable versions

If you want to return to the next most recent stable release, follow these instructions:

Remove the current stable packages and PPA:

sudo apt purge kodi*
sudo add-apt-repository -rP team-xbmc/ppa

Then install the "oldstable" version with the following commands:

sudo add-apt-repository -ysP team-xbmc/kodi-old
sudo apt 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 the xbmc-nightly repository index, where you will then have to download the appropriate .deb files and manually install them using sudo dpkg -i [path to downloaded file].

Uninstalling

If you need to uninstall Kodi and purge its global configuration files (for instance, in the attempt to troubleshoot a persistent crash or other errors), do so by using the first of the following commands. If that fails to solve the issue, you will likely need to remove your user settings folder with all of your settings and library data to return to a state equivalent to what existed before Kodi was first installed on the system. This will not delete any videos or music, but just the settings and library data itself, but it is still recommended to keep a backup of them in case it's discovered that they weren't at issue and you are able to effect another solution. An example of how to accomplish a backup and then deletion of your user settings is provided on the last two lines, the highlighted one being responsible for making the backup which can thereafter be found in your home folder with the filename kodi-backup_timestamp.tar.xz.

sudo apt purge kodi*
tar cf - "${HOME}/.kodi/" | xz -z9e - >"${HOME}/kodi-backup_$(date +%m%d%y-%H%M).tar.xz"
rm -Ri "${HOME}/.{kodi,xbmc}/"

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) and 10 (Buster), Kodi is available in the default "main" Debian repository. You can check this with 'apt show kodi' to show the description or 'apt policy kodi' to check available version and whether it's installed. The version in the Debian main repository is an older version (built by Debian) and is not maintained by the Kodi team.

In Debian 9 and 10, update APT and install:

sudo apt update
sudo apt 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


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. See our Compiling Kodi guide.