Archive:Linux FAQ: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
m (Ned Scott moved page XBMC for Linux specific FAQ to Linux FAQ over redirect)
No edit summary
Line 11: Line 11:


=== Linux XBMC log ===
=== Linux XBMC log ===
In Linux your XBMC log is located in the path below: (bear in mind this is when logged in as the xbmc user and not root)
In Linux your XBMC log is located in the path below (bear in mind this is when logged in as the xbmc user and not root):


:'''''See also:''''' [[SSH|Accessing XBMC via SSH]] e.g. Putty
:'''''See also:''''' [[SSH|Accessing XBMC via SSH]] e.g. Putty
Line 17: Line 17:


<source lang="bash">$HOME/.xbmc/temp/xbmc.log</source>
<source lang="bash">$HOME/.xbmc/temp/xbmc.log</source>
You can generate a debug.log [http://en.wikipedia.org/wiki/Pastebin Pastebin] link automatically quickly to post anywhere that requires a debug.log.
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 />
<br />
{{Note|Don't forget to [[Log file#Enable Debugging|'''Enable Debugging''']]}}<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
<source lang="bash">sudo apt-get install pastebinit -y


cat $HOME/.xbmc/temp/xbmc.log | pastebinit</source>
cat $HOME/.xbmc/temp/xbmc.log | pastebinit</source>


If you run into issues it is helpful to keep certain things in mind, specially when your thinking about starting a thread of xbmc forums or open a bug report on XBMC bug tracker. Below is a list of information that '''should be''' included in a forum post '''but is not limited to'''.<br />
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 your experiencing.
* '''Compulsory''' xbmc.log with '''debugging enabled''', which contains the problem or issue you're experiencing.
* '''Video driver problems:''' Include a copy of your '''/var/log/Xorg.0.log''' in addition to your debug.log.
* '''Video driver problems:''' Include a copy of your '''/var/log/Xorg.0.log''' in addition to your debug log.
* '''Use a pastesite''' for logs dont post logs in-line on forums. '''On trac''' you should attach/upload the logs with your report.
* '''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.)
* '''System specs:''' (CPU, '''GPU''', etc.)
* '''Playback Problems:''' include '''Video''' codec and container or '''audio''' codec and container, if possible include samples.
* '''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.
* '''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.
* '''Steps''' to duplicate your problem in detail.
Line 53: Line 53:


=== Does XBMC for Linux support Blu-ray or HD DVD playback with or without menus? ===
=== Does XBMC for Linux support Blu-ray or HD DVD playback with or without menus? ===
: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.
: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.
: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.
Line 67: Line 67:


=== What is current recommended hardware requirements for XBMC ===
=== What is current recommended hardware requirements for XBMC ===
: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).
: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 ===
=== XBMC for Linux minimum requirements ===
Line 74: Line 74:
== Troubleshooting ==
== Troubleshooting ==
=== Boot issues ===
=== Boot issues ===
Some Intel GPU's have issues with rc6 it can be disabled via grub.
Some Intel GPUs have issues with rc6 it can be disabled via grub.
<source lang="bash">sudo nano /etc/default/grub</source>
<source lang="bash">sudo nano /etc/default/grub</source>


Line 97: Line 97:
:Deinterlacing in Intel hardware needs cutting edge drivers like '''xserver-xorg-video-intel''', '''libva-intel-vaapi-driver'''<br />
:Deinterlacing in Intel hardware needs cutting edge drivers like '''xserver-xorg-video-intel''', '''libva-intel-vaapi-driver'''<br />


Below we can find forum discussions on various relevant topics, from complete setup's and configuration of drivers. NVidia forum discussion link does not exist yet, please add them if you know of any relevant ones.<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:|NVidia Place Holder forum discussion thread ?]]}}
Line 104: Line 104:


=== Upgrading NVidia drivers in Ubuntu and variants ===
=== Upgrading NVidia drivers in Ubuntu and variants ===
'''For Linux''' updating 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.
'''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 if you use other 3rd party ppa's (repositories) that hold versions of the NVidia drivers are removed, for sanity reasons '''dont remove any Ubuntu sources''', as that is likely to break something if you remove any.
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">
<source lang="bash">
Line 118: Line 118:


=== Intel SNA Acceleration ===
=== Intel SNA Acceleration ===
Intel uses vaapi for GPU accelerated video playback decoding, however there are other acceleration methods in the pipeline like SNA.
Intel uses VAAPI for GPU-accelerated video playback decoding, however there are other acceleration methods in the pipeline like SNA.
Using GPU acceleration is a essential part to getting smooth XBMC GUI rendering and more importantly achieving smooth playback on Video materials, if your GPU supports acceleration of your file types.
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.
Create or edit your existing '''/etc/X11/xorg.conf''' and add to section '''Device''' as below.


Line 128: Line 128:
EndSection</pre>
EndSection</pre>


Understand '''SNA''' see: [http://www.phoronix.com/scan.php?page=article&item=intel_sna_july2012&num=1 '''Intel SNA vs. UXA On Ivy Bridge''']
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]]}}
{{forum link2|[[forum:144633|Optimal video settings for Intel GPU forum discussion thread]]}}
Line 141: Line 141:
:The result should be:
:The result should be:
<pre>Direct rendering: Yes</pre>
<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.
: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 ==
== 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 Linux distros in use, for e.g. Archlinux, Debian, gentoo and many others. Feel welcome to show how you can upgrade packages in other distros. Though this one is designed for XBMCbuntu and Ubuntu variant installs.
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? ===
=== Where are XBMC Packages for Ubuntu/Debian? ===
Line 162: Line 162:


==== Ubuntu manual XBMC upgrade process ====
==== 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.}}
{{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 transition to upgrade XBMC manually and/or change the repository being used if you have a different source ppa (it is recommended to remove any ppa's that contain same package sources). Attempting to simplify the process, If you use other Distros please dont hesitate to update/add subsection the relevant parts with your specific Distro information.
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'''.


As below connect to your Debian based Distro via [[SSH]] to run these commands.
Connect to your Debian/Ubuntu-based distro via [[SSH]] and run the commands below:


<source lang="bash">
<source lang="bash">
Line 208: Line 208:


=== '''Why do I get no audio devices detected ?''' ===
=== '''Why do I get no audio devices detected ?''' ===
If you have installed lightdm this will happen, its is not a XBMC issue. Workaround exists.
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>
:<big>'''''See: [[XBMCbuntu#XBMCbuntu no audio devices|XBMCbuntu no audio devices''''']]</big>


Line 217: Line 217:


=== '''No sound in XBMC''' ===
=== '''No sound in XBMC''' ===
{{Note|'''<big>Unmute channels in alsamixer</big>''' in all cases if your getting no sound via e.g. '''<big>HDMI</big>''' just for guidance a couple of quick reference commands below.}}
{{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.}}'''
{{tip|Substitute '''IEC958''' with your device ID depending on your '''{{code|aplay -l}} output.}}'''
<source lang="bash">
<source lang="bash">
Line 226: Line 226:
</source>
</source>


{{note|Make sure that in alsamixer your correct sound card is in use, to change you card you need {{keypress|F6}} and then try either card to make sure its not something as simple as using correct card. Sometimes the onboard card may not be the card you want or need.}}
{{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|Some 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 its not in use. For e.g. Your using a soundblaster or Video card that are able to output audio e.g. HDA Nvidia.}}
{{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''' ===
=== '''HDMI Channel Audio remapping''' ===
Under some systems e.g. ION in combination with some Receivers the HDMI channels may be incorrectly mapped.
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''']]
:'''''See also:'' [[HOW-TO:Remap_HDMI_audio_on_Gen_1_ION_-_Linux|HOW-TO: Remap HDMI audio on Gen 1 ION - Linux''']]


Line 236: Line 236:
This is a grail for some XBMC users and with inclusion of [[AudioEngine]] it becomes more complex and even impossible in some cases.
This is a grail for some XBMC users and with inclusion of [[AudioEngine]] it becomes more complex and even impossible in some cases.


'''puntloos''' a XBMC forums 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.
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 />
<br />



Revision as of 20:52, 1 February 2014

Home icon grey.png   ▶ General topics
▶ Devices
▶ FAQs
▶ Linux
▶ Linux FAQ
Cleanup.png This page or section may require cleanup, updating, spellchecking, reformatting and/or updated images. Please improve this page if you can. The discussion page may contain suggestions.


Frequently Asked Questions for XBMC running under Linux-based operating systems. Template:XBMC FAQ


General FAQ

See also: XBMC all platforms FAQ for FAQs that apply to all versions of XBMC.

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.

See also: Installing XBMC for Linux for How-to install XBMC in other distros

Linux XBMC log

In Linux your XBMC log is located in the path below (bear in mind this is when logged in as the xbmc user and not root):

See also: Accessing XBMC via SSH e.g. Putty

Note: The location of the log assumes you are logged in as user and not root.

$HOME/.xbmc/temp/xbmc.log

You can generate a debug log Pastebin link automatically. This allows you to quickly post a log to anywhere that requires it.
Note: Don't forget to Enable Debugging when creating the log so that maximum detail is available

sudo apt-get install pastebinit -y

cat $HOME/.xbmc/temp/xbmc.log | pastebinit

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.

  • Compulsory xbmc.log with debugging enabled, which contains the problem or issue you're experiencing.
  • 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 snag.gy or postimage.


For help/support visit XBMC Community Forums or IRC #xbmc-linux

Where is the UserData folder?

$HOME/.xbmc/userdata

Where is XBMC installed?

The installation paths are like below:

Please remember that no user XBMC configuration files are kept here, refer to userdata for user-space files.

/usr/share/xbmc/

/usr/lib/xbmc/

Does XBMC for Linux support Blu-ray or HD DVD playback with or without menus?

Yes, without menus. As of Dharma (10.0), XBMC includes support for playback of unencrypted Blu-ray directories when libbluray is installed. However, XBMC must be compiled from source. Installing from a repository like the 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.

Playback Blu-ray Disc in XBMC with MakeMKV see below.

Attention talk.png playback Blu-ray Disc in XBMC for Linux with MakeMKV (Plugin Addon) Discussion thread

Which are the supported Linux distributions?

Check the install page for a list of supported distributions.

What is current recommended hardware requirements for XBMC

For end-users the recommended minimum requirement is an x86-based computer, with a 3D GPU (Graphics Processing Unit) that at least supports Shader Model 3.0 and 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 DirectX version 9.0c or later usually meet all of those mentioned requirements, (Team-XBMC recommends NVIDIA GeForce 6150 or later as NVIDIA are currently the manufacturer that offers good device-drivers for Linux (and NVIDIA GeForce 6150 or later supports OpenGL 2.0)).

XBMC for Linux minimum requirements

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


Troubleshooting

Boot issues

Some Intel GPUs have issues with rc6 it can be disabled via grub.

sudo nano /etc/default/grub

Append i915.i915_enable_rc6=0 to:

GRUB_CMDLINE_LINUX_DEFAULT="quiet splash i915.i915_enable_rc6=0"
  • Press ctrl+X say YES to save file
Then run
sudo update-grub

Video Device Driver

Incomplete.png INCOMPLETE:
This page or section is incomplete. Please add information or correct uncertain data which is marked with a ?
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 click this (link)
  • For ATI drivers follow the guide 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

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.

Attention talk.png NVidia Place Holder forum discussion thread ?
Attention talk.png XVBA for AMD Radeon/Fusion/NVidia forum discussion thread
Attention talk.png Intel GPU forum discussion thread


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.

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


Attention talk.png NVidia Drivers updates XBMCBuntu, Ubuntu and variants forum discussion thread


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.

Section "Device"
Identifier "Intel Graphics"
Driver "intel"
Option "AccelMethod" "sna"
EndSection

For more information on SNA, see: Intel SNA vs. UXA On Ivy Bridge

Attention talk.png 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:
# glxinfo | grep -i direct
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 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
Xvba and improved Vdpau (not mainline)
3rd party (contains older Ubuntu support etc)


Ubuntu manual XBMC upgrade process

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

sudo apt-get install python-software-properties pkg-config
sudo add-apt-repository -r ppa:current_XBMC_providing_ppa
sudo add-apt-repository ppa:the_ppa_you_wish_to_use
sudo apt-get update
sudo apt-get upgrade
sudo apt-get remove xbmc xbmc.bin
sudo apt-get install xbmc xbmc.bin

Arch manual XBMC upgrade process

This part needs to be updated ?

FreeBSD manual XBMC upgrade process

Upgrading XBMC in FreeBSD is pretty simple, as long as a new version exists in port
Update you port tree
portsnap fetch update
Update XBMC
portmaster multimedia/xbmc

Gentoo manual XBMC upgrade process

This part needs to be updated ?

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:
Section "Extensions"
    Option "Composite" "Disable"
EndSection

Or in terminal

sudo nvidia-xconfig --no-composite
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.

See: XBMCbuntu no audio devices

Required packages

sudo apt-get install alsa-utils libasound2

No sound in XBMC

Note: Unmute channels in alsamixer in all cases if you're getting no sound via e.g. HDMI. Just for guidance, a couple of quick reference commands are listed below.

Tip Tip: Substitute IEC958 with your device ID depending on your
​aplay -l​
output.
amixer -q set Master 100% unmute 
amixer -q set PCM 100% unmute
amixer -q set 'IEC958',1 unmute
amixer -q set 'IEC958',0 unmute

Note: Make sure that your correct sound card is in use in alsamixer. To change your card, press 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

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.

Attention talk.png Setting up dual audio forum discussion thread

Known issues

See: XBMC v12 (Frodo) issues