Archive:Linux FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
No edit summary
m (Text replacement - "{{Helix updated}}" to "")
 
(71 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{mininav|[[General topics]]{{l2|[[Devices]]}}|[[FAQs]]{{l2|[[Linux]]}} }}
{{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]'''.}} }}
{{cleanup}}
{{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>
There are no official XBMC builds in other distros outside Ubuntu yet, if you use something other than Ubuntu check to see if XBMC is available via repositories.
:<big>''See also: '''[[Installing XBMC for Linux]]''' for How-to install XBMC in other distros''</big>


{| width="100%"


{{FAQ|1= Support
<section begin="intro" />'''F'''requently '''A'''sked '''Q'''uestions for Kodi running under Linux-based operating systems.<section end="intro" />
| BGcolor=
| Question= I'm here because I've got a problem, so what do I do if I'm still stuck afterwards?
| Answer=
If you run into issues it is helpful to keep certain things in mind, especially when you're thinking about starting an XBMC forum thread or opening a report on the XBMC bug tracker. Below is a list of information that should be included in a forum post '''as a minimum'''. As a rule, you should include anything that's relevant, such as recent changes, detailed media information, etc.<br />


* '''Compulsory''' xbmc.log with '''debugging enabled''', which contains the problem or issue you're experiencing.
__TOC__
* '''Video driver problems:''' Include a copy of your '''/var/log/Xorg.0.log''' in addition to your debug log.
{{-}}
* '''Use a pastesite''' for logs: do not post logs in-line on forums. '''On trac''' you should attach/upload the logs with your report.
* '''System specs:''' (CPU, '''GPU''', etc.)
* '''Playback Problems:''' include '''Video''' codec and container or '''audio''' codec and container. If possible, include samples.
* '''Details''' of steps you took to attempt to fix it, if any. Describe what it is you tried when posting.
* '''Steps''' to duplicate your problem in detail.
* '''Screenshots''' that may help illustrate your problem or show your current settings. Use sites like [http://snag.gy/ snag.gy] or [http://www.postimage.org/ postimage].


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


For help/support visit [http://forum.xbmc.org/ '''XBMC Community Forums'''] or IRC [irc://freenode.net/ '''#xbmc-linux''']
=== Supported hardware ===
For x86 hardware:
{{collapse top}}
:{{#lst:Supported hardware|Linux}}
{{collapse bottom}}


{{see also|HOW-TO:Submit a bug report}}
=== How to install or update Kodi for Linux ===
}}
{{Main|HOW-TO:Install Kodi for Linux}}


{{FAQ|1= Logfile
| BGcolor= WhiteSmoke
| Question= Where's my log file?
| Answer=
In Linux your XBMC log is located in the path below:


{{note|The location of the log assumes you are logged in as the '''<big>xbmc user</big>''' and not '''<big>root</big>'''.}}<br />
=== 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.


<source lang="bash">$HOME/.xbmc/temp/xbmc.log</source>
=== What version/nightly build/beta of Kodi am I running? ===
<br />
: Kodi main menu > System > Lower submenu > System info. '''Note the build date.'''
:'''''See also:''''' [[SSH|Accessing XBMC via SSH]] e.g. Putty
}}


{{FAQ|1= Debugfile
| BGcolor=
| Question= How do I upload my log file?
| Answer=
You can generate a debug log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically. This allows you to quickly post a log to anywhere that requires it.
<br />
{{Note|Don't forget to [[Log file#Enable Debugging|'''Enable Debugging''']] when creating the log so that maximum detail is available}}<br />
<source lang="bash">sudo apt-get install pastebinit -y


cat $HOME/.xbmc/temp/xbmc.log | pastebinit</source>
=== How to autostart Kodi in desktop mode ===
}}


{{FAQ|1= UserData
A)
| BGcolor= WhiteSmoke
| Question= Where's the UserData folder?
| Answer=
<source lang="bash">$HOME/.xbmc/userdata</source>
}}


{{FAQ|1= InstallationDirectory
<pre>
| BGcolor=
sudo sed -i "1i @kodi" /etc/xdg/lxsession/LXDE-pi/autostart
| Question= Where is XBMC installed?
</pre>
| Answer=
The installation paths are as below:


'''Please remember''' that '''no''' user XBMC configuration files are kept here, refer to [[userdata]] for user-space files.
or B)


<pre>/usr/share/xbmc/
<pre>
mkdir -p ~/.config/autostart
ln -s /usr/bin/kodi ~/.config/autostart
</pre>


/usr/lib/xbmc/</pre>
Source of this information is HOW TO: Autostart Kodi for Linux
}}


{{FAQ|1= DiscPlayback
=== What are the differences between Ubuntu + Kodi and LibreELEC? ===
| BGcolor= WhiteSmoke
* '''Ubuntu + Kodi:''' This setup will give you the full Unity desktop environment that has enough software installed to be a general computing solution.
| Question= Does XBMC for Linux support Blu-ray or HD DVD playback with or without menus?
* '''[[LibreELEC]]:''' An appliance distribution. Getting software other than what is provided in the basic distribution will be a little difficult, but not impossible.
| Answer=
Yes, without menus. As of Dharma (10.0), XBMC 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.


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.
=== Getting more help with Kodi for Linux ===
:* '''[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.


To play Blu-ray discs in XBMC with MakeMKV, see below.


{{forum link2|[[forum:67420|playback Blu-ray Disc in XBMC for Linux with MakeMKV (Plugin Addon) Discussion thread]]}}
=== Audio issues ===
}}
:For most audio issues, including configuration examples, see '''Audio''' and '''Audio troubleshooting'''.
 
{{FAQ|1= Distros
| BGcolor=
| Question= What Linux distributions are supported?
| Answer=
Check the '''[[HOW-TO:Install XBMC for Linux|install page]]''' for a list of supported distributions.
}}
 
{{FAQ|1= Hardware
| BGcolor= WhiteSmoke
| Question= What are the current recommended hardware requirements for XBMC?
| Answer=
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)).
}}
 
{{FAQ|1= LinuxHardware
| BGcolor=
| Question= XBMC for Linux minimum requirements
| Answer=
{{#lst:Supported hardware|Linux}}
}}
 
== Troubleshooting ==
=== Boot issues ===
Some Intel GPUs have issues with rc6 it can be disabled via grub.
<source lang="bash">sudo nano /etc/default/grub</source>
 
Append '''i915.i915_enable_rc6=0''' to:
 
<source lang="xml">GRUB_CMDLINE_LINUX_DEFAULT="quiet splash i915.i915_enable_rc6=0"</source>
 
* Press {{keypress|ctrl|X}} say '''YES''' to save file
 
;Then run
 
<source lang="bash">sudo update-grub</source>
=== Video Device Driver ===
{{incomplete}}
: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.
 
=== Begin but install the video drivers the Ubuntu Way ===
:* For '''NVIDIA''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/Nvidia click this (link)]
:* For '''ATI''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/ATI click this (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.
:Make sure your hardware acceleration '''libva''' or '''sna''' is installed and working.
:Deinterlacing in Intel hardware needs cutting edge drivers like '''xserver-xorg-video-intel''', '''libva-intel-vaapi-driver'''<br />
 
Below, you can find forum discussions on various relevant topics, including complete setups and configuration of drivers. '''No NVidia forum discussion link exists yet, so please add links if you know of any relevant ones.'''<br />
 
{{forum link2|[[forum:|NVidia Place Holder forum discussion thread ?]]}}
{{forum link2|[[forum:116996|XVBA for AMD Radeon/Fusion/NVidia forum discussion thread]]}}
{{forum link2|[[forum:114368|Intel GPU forum discussion thread]]}}<br />
 
=== Upgrading NVidia drivers in Ubuntu and variants ===
'''For Linux''', updating your graphics drivers can be a decisive step in resolving some issues. Ubuntu and XBMCbuntu ship with often outdated drivers that do not support a platform fully.
Make sure that old versions of the NVidia drivers are removed if you use other 3rd party PPAs (repositories). For the sake of your sanity, '''don't remove any Ubuntu sources''', as that is likely to break something if you remove them.
 
<source lang="bash">
sudo apt-get install python-software-properties pkg-config
sudo add-apt-repository -r ppa:the_3rd_party_ppa_you_wish_to_remove_here
sudo add-apt-repository ppa:ubuntu-x-swat/x-updates
apt-get update
sudo apt-get install nvidia-current nvidia-settings
</source><br />
 
{{forum link2|[[forum:142220|NVidia Drivers updates XBMCBuntu, Ubuntu and variants forum discussion thread]]}}<br />
 
=== Intel SNA Acceleration ===
Intel uses VAAPI for GPU-accelerated video playback decoding, however there are other acceleration methods in the pipeline like SNA.
The use of GPU acceleration is an essential part of getting both smooth video playback and a lag-free interface (GUI).
Create or edit your existing '''/etc/X11/xorg.conf''' and add to section '''Device''' as below.
 
<pre>Section "Device"
Identifier "Intel Graphics"
Driver "intel"
Option "AccelMethod" "sna"
EndSection</pre>
 
For more information on '''SNA''', see: [http://www.phoronix.com/scan.php?page=article&item=intel_sna_july2012&num=1 '''Intel SNA vs. UXA On Ivy Bridge''']
 
{{forum link2|[[forum:144633|Optimal video settings for Intel GPU forum discussion thread]]}}
 
=== Verify OpenGL support ===
:Once you have your drivers in place, you need to make sure that OpenGL is properly configured. Run the following command:
 
<source lang="bash">
# glxinfo | grep -i direct
</source>
 
:The result should be:
<pre>Direct rendering: Yes</pre>
: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 PPAs, but we recognise that Ubuntu is only one of the many Linux distributions in use and users will also have Archlinux, Debian or Gentoo (amongst many others). Please feel free to provide details on how you can upgrade packages on these and other distros. The details below are thus really intended for XBMCbuntu and Ubuntu variant (Xubuntu, Kubuntu, Mint...) installations.
 
=== Where are XBMC Packages for Ubuntu/Debian? ===
;Official
* https://launchpad.net/~team-xbmc/+archive/ppa  '''ppa:team-xbmc/ppa'''
* https://launchpad.net/~team-xbmc/+archive/unstable  '''ppa:team-xbmc/unstable'''
* https://launchpad.net/~team-xbmc/+archive/xbmc-nightly  '''ppa:team-xbmc/xbmc-nightly'''
;Xvba and improved Vdpau (not mainline)
* https://launchpad.net/~wsnipex/+archive/xbmc-xvba  '''ppa:wsnipex/xbmc-xvba'''
* https://launchpad.net/~wsnipex/+archive/xbmc-xvba-frodo  '''ppa:wsnipex/xbmc-xvba-frodo'''
 
;3rd party (contains older Ubuntu support etc)
* https://launchpad.net/~nathan-renniewaldock/+archive/xbmc-stable  '''ppa:nathan-renniewaldock/xbmc-stable'''
* https://launchpad.net/~nathan-renniewaldock/+archive/xbmc-nightly  '''ppa:nathan-renniewaldock/xbmc-nightly'''
* http://www.loggn.de/ubuntu-xbmc-repository-11-eden-airplay-pvr-livetv/
 
 
==== Ubuntu manual XBMC upgrade process ====
{{greenv|'''NOTICE:'''|[[XBMC v12 (Frodo) FAQ#What might break when upgrading to v12.3F .28Audio and Video.2C add-ons.2C skins.2C remotes.29|'''What might break when upgrading to v12''']] is a must-read for users upgrading to a final version.}}
Below is the process to upgrade XBMC manually and/or change the repository being used if you have a different source PPA (it is recommended to remove any previous PPAs that contain the same package sources). '''If you use other distros, please update or add a subsection with relevant information'''.


Connect to your Debian/Ubuntu-based distro via [[SSH]] and run the commands below:
=== Video tearing on Nvidia GPUs ===
: 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]
sudo apt-get install python-software-properties pkg-config
:*# Install CCSM (Compiz Config Settings Manager): <code>sudo apt-get install compizconfig-settings-manager</code>
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa
:*# Open Compiz Config Settings Manager
sudo add-apt-repository ppa:the_ppa_you_wish_to_use
:*# Check the option "Unredirect Fullscreen Window", which should be under the "Composite" section.
sudo apt-get update
sudo apt-get upgrade
sudo apt-get remove xbmc xbmc.bin
sudo apt-get install xbmc xbmc.bin
</source>


==== Arch manual XBMC upgrade process ====
This part needs to be updated <big>'''?'''</big>


==== FreeBSD manual XBMC upgrade process ====
:* '''Solution 2:''' Disable the composite extension.
:Upgrading XBMC in FreeBSD is pretty simple, as long as a new version exists in port
:::'''1.''' Add this to the end of /etc/X11/xorg.conf: (make a new file if xorg.conf doesn't exist)
 
; Update you port tree:
<pre>portsnap fetch update</pre>
; Update XBMC:
<pre>portmaster multimedia/xbmc</pre>
 
==== Gentoo manual XBMC upgrade process ====
This part needs to be updated <big>'''?'''</big>
 
=== 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 Disable composite in xorg.conf, like so:
<pre>Section "Extensions"
<pre>Section "Extensions"
    Option "Composite" "Disable"
  Option "Composite" "Disable"
EndSection</pre>
EndSection</pre>
Or in terminal
:::'''2.''' Then log in with a gnome classic session (without the composite extension compiz doesn't work).
<source lang="bash">
:::'''3.''' Also make sure to set Vertical blank sync to Always enabled in Kodi.
sudo nvidia-xconfig --no-composite
</source>
: '''Minimal xorg.conf for NVidia''' [[Minimal NVidia xorg.conf]]
 
=== Audio issues ===
For XBMC v12 Frodo specific settings please see '''[[AudioEngine]]'''.
 
=== '''Why do I get no audio devices detected ?''' ===
If you have installed lightdm this will happen, it's is not a XBMC issue. A workaround exists.
:<big>'''''See: [[XBMCbuntu#XBMCbuntu no audio devices|XBMCbuntu no audio devices''''']]</big>
 
=== Required packages ===
<source lang="bash">
sudo apt-get install alsa-utils libasound2
</source>
 
=== '''No sound in XBMC''' ===
{{Note|'''<big>Unmute channels in alsamixer</big>''' in all cases if you're getting no sound via e.g. '''<big>HDMI</big>'''. Just for guidance, a couple of quick reference commands are listed below.}}
{{tip|Substitute '''IEC958''' with your device ID depending on your '''{{code|aplay -l}} output.}}'''
<source lang="bash">
amixer -q set Master 100% unmute
amixer -q set PCM 100% unmute
amixer -q set 'IEC958',1 unmute
amixer -q set 'IEC958',0 unmute
</source>
 
{{note|Make sure that your correct sound card is in use in alsamixer. To change your card, press {{keypress|F6}} and then try different cards to make ensure it's not something as simple as using the wrong card - sometimes the onboard card may not be the one you want or need.}}
{{note|For systems that have '''multiple sound cards''' e.g. Intel Azalia (internal) - GT520 (external), you could try to disable the onboard card in '''system BIOS''' if it's not in use. This is suitable where, for example, you're using a Soundblaster or perhaps a video card that also audio e.g. HDA Nvidia.}}
 
=== '''HDMI Channel Audio remapping''' ===
Some combinations of systems (e.g. ION) and receivers may have incorrectly mapped HDMI channels.
:'''''See also:'' [[HOW-TO:Remap_HDMI_audio_on_Gen_1_ION_-_Linux|HOW-TO: Remap HDMI audio on Gen 1 ION - Linux''']]
 
== 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.
 
One XBMC forum user, '''puntloos''', posted his finding which seem to work relatively well for his setup. Bear in mind that this will not be universal, though, and thus may not work under other circumstances.
<br />


{{forum link2|[[forum:145430|Setting up dual audio forum discussion thread]]}}


== Known issues ==
:* '''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
'''''See:''''' [[XBMC v12 (Frodo) issues]]


[[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|*]]
[[Category:Troubleshooting]]
{{frodo updated}}

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:

How to install or update 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.