Archive:Linux FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>UNiversal
m (Text replacement - "{{Helix updated}}" to "")
 
(175 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{cleanup}}
{{notice|1= {{bigger|1= The Linux FAQ is going though a major overhaul and some things might be missing. For a copy of the old version see '''[http://wiki.kodi.tv/index.php?title=Linux_FAQ&oldid=76795 here]'''.}} }}
{{FAQ header|for XBMC running under Linux-based operating systems.}}
{{XBMC FAQ}}
__TOC__
{{-}}
==General FAQ==
:<big>''See also: '''[[XBMC all platforms FAQ]]''' for FAQs that apply to all versions of XBMC.''</big>


=== Where is the debug log? ===
<pre>$HOME/.xbmc/temp/xbmc.log</pre>
You can generate a debug.log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically quickly to post anywhere that requires a debug.log.
<br />
:{{highlight|'''Note:'''|bordered=yes|color=Lime}} Don't forget to [http://wiki.xbmc.org/index.php?title=Log_file#Enable_Debugging Enable Debugging]
<pre>sudo apt-get install pastebinit -y


cat $HOME/.xbmc/temp/xbmc.log | pastebinit</pre>
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Kodi running under Linux-based operating systems.<section end="intro" />


:See also [[HOW-TO Submit a Proper Bug Report]].
__TOC__
{{-}}


=== Where is the UserData folder? ===
=== Supported Linux distributions ===
<pre>$HOME/.xbmc/userdata</pre>
:* Team Kodi provides precompiled binaries for Ubuntu from the '''Team Kodi PPA'''. In the future there will also be precompiled binaries for Debian and Steam OS.
:* Team Kodi recognizes '''[[LibreELEC]]''' versions of Kodi as "pretty damn awesome".
:* Generally speaking, as long as Kodi is compiled per recommended guidelines (see '''[[Compiling Kodi]]'''), those builds are considered "kosher".
:* Kodi builds that use external ffmpeg/libav are not supported and are strongly discouraged.


=== Where is XBMC installed? ===
=== Supported hardware ===
<pre>usr/share/xbmc</pre>
For x86 hardware:
{{collapse top}}
:{{#lst:Supported hardware|Linux}}
{{collapse bottom}}


=== Does XBMC for Linux support Blu-ray or HD DVD playback with or without menus? ===
=== How to install or update Kodi for Linux ===
:Yes, without menus. As of Dharma (10.0) includes support for playback of '''unencrypted''' Blu-ray directories when [http://www.videolan.org/developers/libbluray.html libbluray] is installed. However, XBMC must be compiled from [https://github.com/xbmc/xbmc source]. Installing from a repository like the [https://launchpad.net/~team-xbmc/+archive/unstable Team-XBMC unstable ppa] will not recognize whether libbluray is installed.
{{Main|HOW-TO:Install Kodi for Linux}}


:Currently, only the longest title is played from the Blu-ray directory, even on multi-video Blu-rays (e.g. TV shows). To play a Blu-ray directory, select the /BDMV/index.bdmv in the Blu-ray directory. If stacking is enabled, selecting the Blu-ray directory folder will start playback.


;Frodo v12 includes better support for bluray .iso and folder, there is still work in progress in this area for post Frodo.
=== Kodi for Linux version ===
: The current stable version of Kodi for Linux is {{Current version}}. This is the same code that all of the other platforms (Android, iOS, Mac, Windows, etc) are using.


Playback Blu-ray Disc in XBMC with MakeMKV see below.
=== What version/nightly build/beta of Kodi am I running? ===
: Kodi main menu > System > Lower submenu > System info. '''Note the build date.'''


{{forum link2|[[forum:67420|playback Blu-ray Disc in XBMC for Linux with MakeMKV (Plugin Addon) Discussion thread]]}}


=== Which are the supported Linux distributions? ===
=== How to autostart Kodi in desktop mode ===
:* Supported Linux Operating-System installed on a supported computer, currently supported OS are:
:** [http://www.ubuntu.com/download/desktop Ubuntu Desktop] both x86 and x86_64
:** [http://www.ubuntu.com/download/server Ubuntu Server] both x86 and x86_64
:** [https://help.ubuntu.com/community/Installation/MinimalCD Ubuntu minimal] both x86 and x86_64
:* It is possible to compile and run 32-bit XBMC under 64-bit (AMD64/EMT64) Ubuntu if you run it in a 32bit chroot.


=== What is current recommended hardware requirements for XBMC ===
A)
:For end-users the recommended minimum requirement is an [http://en.wikipedia.org/wiki/X86 x86-based computer], with a [http://en.wikipedia.org/wiki/Graphics_Processing_Unit 3D GPU (Graphics Processing Unit)] that at least supports [http://en.wikipedia.org/wiki/Shader_model Shader Model 3.0] and [http://en.wikipedia.org/wiki/OpenGL OpenGL 2.0] (that features 24bpp or 32bpp for 3D hardware-acceleration support, which the XBMC GUI needs to run smoothly at an acceptable frame-rate). Graphic adapters that support [http://en.wikipedia.org/wiki/DirectX DirectX version 9.0c] or later usually meet all of those mentioned requirements, ([[Team-XBMC]] recommends [http://en.wikipedia.org/wiki/Nvidia NVIDIA GeForce 6150 or later] as NVIDIA are currently the manufacturer that offers [http://en.wikipedia.org/wiki/Graphics_hardware_and_FOSS good device-drivers for Linux] (and [http://en.wikipedia.org/wiki/Nvidia NVIDIA GeForce 6150 or later] supports OpenGL 2.0).


=== XBMC for Linux minimum requirements ===
<pre>
{{#lst:Supported hardware|Linux}}
sudo sed -i "1i @kodi" /etc/xdg/lxsession/LXDE-pi/autostart
</pre>


== Troubleshooting ==
or B)
=== Graphic/video issues ===
==== Video Device Driver ====
:Most of the problems that you encounter with slow display or OpenGL related errors are because you do not have the proper or outdated display drivers installed.
{{incomplete}}
===== Begin but install the video drivers the Ubuntu Way =====
:* For '''NVIDIA''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/Nvidia here (link)]
:* For '''ATI''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/ATI here (link)]
:* For '''Intel''' it is simpler since the drivers are open source so they are usually already pre-installed. You need to make sure that you use the newer '''intel''' driver and not the older '''i810''' driver or the 'vesa' driver. This could be verified by checking the 'Driver' value in /etc/X11/xorg.conf.<br />


Below we can find forum discussions on various relevant topics, from complete setup's and configuration of drivers. Nvidia and intel forum discussion links dot exist yet, please add them if you know of any relevant ones.<br />
<pre>
 
mkdir -p ~/.config/autostart
{{forum link2|[[forum: |Nvidia Place Holder forum discussion thread ?]]}}
ln -s /usr/bin/kodi ~/.config/autostart
{{forum link2|[[forum:116996|XVBA for AMD Radeon/Fusion forum discussion thread]]}}
</pre>
{{forum link2|[[forum:  |intel GPU forum discussion thread ?]]}}
 
=====Intel I3 3225 xorg.conf with sna=====
 
Create or edit your existing '''/etc/X11/xorg.conf''' and add the below.


<pre>Section "Device"
Source of this information is HOW TO: Autostart Kodi for Linux
Identifier "Intel Graphics"
Driver "intel"
Option "AccelMethod" "sna"
EndSection</pre>


To use sna see: [http://www.phoronix.com/scan.php?page=article&item=intel_sna_july2012&num=1 '''Intel SNA vs. UXA On Ivy Bridge''']
=== What are the differences between Ubuntu + Kodi and LibreELEC? ===
* '''Ubuntu + Kodi:''' This setup will give you the full Unity desktop environment that has enough software installed to be a general computing solution.
* '''[[LibreELEC]]:''' An appliance distribution. Getting software other than what is provided in the basic distribution will be a little difficult, but not impossible.


{{forum link2|[[forum:1242040|Optimal video settings for Intel i3 3225 forum discussion thread]]}}


==== Verify OpenGL support ====
=== Getting more help with Kodi for Linux ===
:Once you have your drivers in place, you need to make sure that OpenGL is properly configured. Run the following command:
:* '''[http://forum.kodi.tv/forumdisplay.php?fid=52 Kodi for Linux specific help forum]'''
:* '''[irc://irc.freenode.org/Kodi #Kodi]''' [[w:IRC|IRC]] chat channel on irc.freenode.org.


<source lang="bash">
# glxinfo | grep -i direct
</source>
:The result should be:
: direct rendering: Yes
:If the result is "No" it means that the display driver have not been properly configured. Also, you can run the command glxgears and you should see the wheels turning smoothly.
==Update XBMC from any ppa==
We obviously recommend the use of our ppa's, and we acknowledge that Ubuntu is only a small percentage of the other distros, in use, Like Archlinux, Debian, gentoo and others. feel welcome to show how you can upgrade packages in other distros. Though this one is designed for XBMCbuntu and Other Ubuntu installs.
=== Where are XBMC Packages for Ubuntu/Debian? ===
;Official
*https://launchpad.net/~team-xbmc/+archive/ppa
*https://launchpad.net/~team-xbmc/+archive/unstable
;3rd party (contains older Ubuntu support, XVBA, etc)
*https://launchpad.net/~nathan-renniewaldock/+archive/ppa
*https://launchpad.net/~nathan-renniewaldock/+archive/xbmc-nightly
*http://www.loggn.de/ubuntu-xbmc-repository-11-eden-airplay-pvr-livetv/
*https://launchpad.net/~wsnipex/+archive/xbmc-xvba-testing
====The XBMC Upgrade in Ubuntu properly====
While Ubuntu is not the only Linux distro but it is the main used by XBMC, below is the transition to upgrade XBMC, attempting to simplify the process.
As below connect to your Debian based Distro via [[SSH]] to run these commands.
<source lang="bash">
sudo apt-get --purge remove xbmc
sudo apt-get install ppa-purge
sudo ppa-purge ppa:whatever-ppa-you-have-now
sudo add-apt-repository ppa:whatever-ppa-here
sudo apt-get update
sudo apt-get install xbmc
</source>
==== Compiz is not compatible with XBMC ====
:Make sure Compiz visual effects is disabled. You can do this by going to System -> Preferences -> Appearance -> Visual Effects. Make sure "None" is selected. Alternatively, you can tell Compiz not to interfere with XBMC. Install and run CompizConfig, and under General Options tick Unredirect Fullscreen Windows.
:For NVIDIA-Graphics use [http://www.loggn.de/ubuntu-vdpau-bilduberlagerungen/ this].
: Minimal xorg.conf for NVidia try [[Minimal NVidia xorg.conf]]


=== Audio issues ===
=== Audio issues ===
{{frodo box|1=
:For most audio issues, including configuration examples, see '''Audio''' and '''Audio troubleshooting'''.
<source lang = "xml">
    For AE (AudioEngine)-specific settings please see the AudioEngine page.
</source>
}}
>> [[AudioEngine|Link to AudioEngine Wiki page]]
==== S/PDIF out for both analog and digital audio ====
:You might find yourself able to get one of both working, but switching from one to the other might not work. Ubuntu and other distributions use PulseAudio to manage ALSA devices and unfortunately it doesn't provide management for passthrough digital audio. The following solution bypasses PulseAudio and forces XBMC to directly use ALSA. There is no need to uninstall or tweak PulseAudio on Ubuntu in any way.


:* Open ~/.asoundrc in a text editor (create the file if it doesn't exist) and add the following:
=== Video tearing on Nvidia GPUs ===
:{{highlight|'''Note:'''|bordered=yes|color=lime}} make sure to use the correct card/device id and replace 'pcm "hw:0,1"' with it. You can find the id's by typing 'aplay -l' in a terminal.'''
: When Kodi is used with Nvidia hardware, tearing will occur when the X composite extension is used.


<source lang="bash">
:* '''Solution 1:''' Enable "Unredirect Fullscreen Window" in Compiz Config Settings Manager. [http://ubuntuforums.org/showthread.php?p=11145045#post11145045]
pcm.dmixer {
:*# Install CCSM (Compiz Config Settings Manager): <code>sudo apt-get install compizconfig-settings-manager</code>
    type dmix
:*# Open Compiz Config Settings Manager
    ipc_key 1024
:*# Check the option "Unredirect Fullscreen Window", which should be under the "Composite" section.
    slave {
        pcm "hw:0,1"
        period_time 0
        period_size 1024
        buffer_size 8192
        #periods 128
        #rate 44100
        rate 48000
    }
    bindings {
        0 0
        1 1
    }
}
</source>


:* Launch XBMC and go to "system->settings->system->audio hardware" and change the following:
AUDIO OUTPUT DEVICE: custom
CUSTOM AUDIO DEVICE: plug:dmixer ('''note: this is case sensitive, even though XBMC shows only capitals!''')
PASSTHROUGH AUDIO DEVICE: iec958


Now all audio output (besides menu sounds) should work including crossfading and switching digital/analog audio sources.
:* '''Solution 2:''' Disable the composite extension.
 
:::'''1.''' Add this to the end of /etc/X11/xorg.conf: (make a new file if xorg.conf doesn't exist)
:{{highlight|'''Note:'''|bordered=yes|color=Lime}} '''Unmute alsamixer''' in all cases if your getting no sound just for guidance a couple of quick ones below.
<pre>Section "Extensions"
<pre>
  Option "Composite" "Disable"
amixer -q set Master 100% unmute
EndSection</pre>
amixer -q set PCM 100% unmute
:::'''2.''' Then log in with a gnome classic session (without the composite extension compiz doesn't work).
</pre>
:::'''3.''' Also make sure to set Vertical blank sync to Always enabled in Kodi.


==Dual Audio setup==
This is a grail for some XBMC users and with inclusion of [[AudioEngine]] it becomes more complex and even impossible in some cases.
A user posted his finding which according to post work relatively well for his hardware, install and setup, bare in mind that this may not work for everyone under all circumstances.
<br />


{{forum link2|[[forum:145430|Setting up dual audio forum discussion thread]]}}
:* '''Solution 3:''' Disable the use of the SDL backing store - this is a bug in Ubuntu which will probably be fixed in due time but could cause tearing right now: http://askubuntu.com/questions/450593/how-do-i-eliminate-screen-tearing-on-14-04-and-xbmc-with-nvidia-331/450673#450673


[[Category:XBMC Manual]]
=== Why can't I update Kodi on Ubuntu 13.04, 13.10, or other release? ===
[[Category:FAQ|Linux]]
: The precompiled binaries from the Team Kodi PPA only work with Ubuntu releases that are still getting support. When Ubuntu drops support for a version then our PPA stops making a binary for it. Simply update Ubuntu itself and then Kodi updates should work again. If you don't want to update Ubuntu that often then we recommend using a long term support (LTS) version of Ubuntu, such as 14.04, which will be supported until 2019.
[[Category:Linux|*]]

Latest revision as of 07:20, 14 November 2020

Emblem-important-yellow.png NOTICE:
The Linux FAQ is going though a major overhaul and some things might be missing. For a copy of the old version see here.


Frequently Asked Questions for Kodi running under Linux-based operating systems.


Supported Linux distributions

  • Team Kodi provides precompiled binaries for Ubuntu from the Team Kodi PPA. In the future there will also be precompiled binaries for Debian and Steam OS.
  • Team Kodi recognizes LibreELEC versions of Kodi as "pretty damn awesome".
  • Generally speaking, as long as Kodi is compiled per recommended guidelines (see Compiling Kodi), those builds are considered "kosher".
  • Kodi builds that use external ffmpeg/libav are not supported and are strongly discouraged.

Supported hardware

For x86 hardware:

Extended content
CPU x86 or x86-64 processor such as: Intel Pentium 4/ Pentium M, AMD Athlon 64 / Opteron, or newer CPU (that support SSE2, which all CPUs made within the last 10-years does).
  • If your GPU/VPU does not support hardware video decoding then you will require a fast modern processor is required to decode some 1080p videos encoded in H.264, VC-1/WMV9, HEVC/H.265 VP9, etc
RAM
  • Recommended: 1GB or more in a HTPC media player appliance-like computer dedicated for Kodi, and 2GB or more in a computer for multipurpose use.
Graphics

Kodi will run on most graphics cards made within the last 10-years or so, though for good hardware video decoding support a little newer graphics cards can be required. This includes most cards from AMD/ATI, Intel, or NVIDIA which support OpenGL 2.0 or later.

AMD/Intel

Video decoding For hardware video decoding, which may be necessary on low-performance CPUs to playback 1080p content, make sure your GPU or VPU supports either VAAPI or VDPAU. For everything but older AMD cards and Nvidia, VAAPI is recommended. On AMD, you might have to start with the environment variable KODI_GL_INTERFACE set to GLX in order to get VDPAU support.
ATI/AMD ( VA-API 2.0.0 or VDPAU ) Intel ( VA-API 1.7.1 ) Nvidia ( VDPAU )
Minimum without HW decoding: ATI Radeon RV710/M92 (HD 4300/4500) Note: These are uvd2.2 cards Arrandale / Clarkdale or newer Nvidia GeForce 6-Series
Minimum for HW decoding of 8-bit H.264 and VC-1: Radeon HD 5000 series or newer Sandy Bridge / Silvermont or newer GeForce 8 series or newer (released 2006)
Minimum for HW decoding of 8-bit HEVC (H.265): AMD Radeon Rx 300 series or newer Braswell / Skylake or newer Nvidia GeForce 900 series (GM20x) or newer
Minimum for HW decoding of 10-bit HEVC (H.265): AMD Radeon 400 series or newer Apollo Lake / Kaby Lake or newer Not available
Minimum for HW decoding of VP9: Stoney Ridge APU or newer; not available for desktop GPUs at the moment Apollo Lake / Kaby Lake or newer Not available
Drive space The Kodi application generally only takes up between 100 to 200 MB of space, depending on how the binary is compiled. Technically speaking, if your hardware supports netbooting, you do not even require a internal storage for either the operating-system or for Kodi.
  • Minimum: 4 to 8GB
  • Recommended: 16GB or more
Depending on how big your video library is. Most of the space required for Kodi comes from the images/artwork cache.

Note: There´s no 304.xxx driver for Ubuntu 18.04 available anymore from the "Graphic Drivers"-ppa. Users who are using GeForce 6-series cards should either stay on an older Ubuntu version or use newer cards

How to install or update Kodi for Linux

Main page: HOW-TO:Install Kodi for Linux


Kodi for Linux version

The current stable version of Kodi for Linux is Kodi v21 Omega. This is the same code that all of the other platforms (Android, iOS, Mac, Windows, etc) are using.

What version/nightly build/beta of Kodi am I running?

Kodi main menu > System > Lower submenu > System info. Note the build date.


How to autostart Kodi in desktop mode

A) 

sudo sed -i "1i @kodi" /etc/xdg/lxsession/LXDE-pi/autostart

or B) 

mkdir -p ~/.config/autostart
ln -s /usr/bin/kodi ~/.config/autostart

Source of this information is HOW TO: Autostart Kodi for Linux

What are the differences between Ubuntu + Kodi and LibreELEC?

  • Ubuntu + Kodi: This setup will give you the full Unity desktop environment that has enough software installed to be a general computing solution.
  • LibreELEC: An appliance distribution. Getting software other than what is provided in the basic distribution will be a little difficult, but not impossible.


Getting more help with Kodi for Linux


Audio issues

For most audio issues, including configuration examples, see Audio and Audio troubleshooting.

Video tearing on Nvidia GPUs

When Kodi is used with Nvidia hardware, tearing will occur when the X composite extension is used.
  • Solution 1: Enable "Unredirect Fullscreen Window" in Compiz Config Settings Manager. [1]
    1. Install CCSM (Compiz Config Settings Manager): sudo apt-get install compizconfig-settings-manager
    2. Open Compiz Config Settings Manager
    3. Check the option "Unredirect Fullscreen Window", which should be under the "Composite" section.


  • Solution 2: Disable the composite extension.
1. Add this to the end of /etc/X11/xorg.conf: (make a new file if xorg.conf doesn't exist)
Section "Extensions"
  Option "Composite" "Disable"
EndSection
2. Then log in with a gnome classic session (without the composite extension compiz doesn't work).
3. Also make sure to set Vertical blank sync to Always enabled in Kodi.


Why can't I update Kodi on Ubuntu 13.04, 13.10, or other release?

The precompiled binaries from the Team Kodi PPA only work with Ubuntu releases that are still getting support. When Ubuntu drops support for a version then our PPA stops making a binary for it. Simply update Ubuntu itself and then Kodi updates should work again. If you don't want to update Ubuntu that often then we recommend using a long term support (LTS) version of Ubuntu, such as 14.04, which will be supported until 2019.
Retrieved from "https://kodi.wiki/index.php?title=Archive:Linux_FAQ&oldid=221881"