Archive:Linux FAQ: Difference between revisions
Prof Yaffle (talk | contribs) No edit summary |
Prof Yaffle (talk | contribs) No edit summary |
||
Line 5: | Line 5: | ||
__TOC__ | __TOC__ | ||
{{-}} | {{-}} | ||
== Caveat == | |||
:There are no official XBMC builds for Linux distributions other than Ubuntu yet. If you use something other than Ubuntu, check to see if XBMC is available via your repositories or normal software installation method. | |||
:<big>''See also: '''[[Installing XBMC for Linux]]''' for how to install XBMC on other distributions.''</big> | |||
== General FAQ == | == General FAQ == | ||
:<big>''See also: '''[[XBMC all platforms FAQ]]''' for FAQs that apply to all versions of XBMC.''</big> | :<big>''See also: '''[[XBMC all platforms FAQ]]''' for FAQs that apply to all versions of XBMC.''</big> | ||
{| width="100%" | {| width="100%" | ||
{{FAQ|1= Support | {{FAQ|1= Support | ||
| BGcolor= | | BGcolor= | ||
| Question= I'm here because I've got a problem, so what do I do if I'm still stuck afterwards? | | Question= I'm here because I've got a problem, so what do I do if I'm still stuck afterwards? | ||
| Answer= | | Answer= | ||
If you run into issues it is helpful to | If you run into issues it is helpful to gather all of the basic information, 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. | * '''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: 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 ''' | * '''Playback Problems:''' include '''video''' codec (e.g. MPEG-2, H.264) and container (e.g. .mkv, .mp4, .avi) or '''audio''' codec (e.g. FLAC, MP3) 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 37: | Line 40: | ||
| Question= Where's my log file? | | Question= Where's my log file? | ||
| Answer= | | Answer= | ||
In Linux your XBMC log is located in | In Linux your XBMC log is located in: | ||
<source lang="bash">$HOME/.xbmc/temp/xbmc.log</source><br /> | |||
{{note|The location of the log assumes you are logged in as the '''<big>xbmc user</big>''' and not '''<big>root</big>'''.}}<br /> | {{note|The location of the log assumes you are logged in as the '''<big>xbmc user</big>''' and not '''<big>root</big>'''.}}<br /> | ||
'''''See also:''''' [[SSH|Accessing XBMC via SSH]] e.g. Putty | |||
}} | }} | ||
Line 53: | Line 53: | ||
<br /> | <br /> | ||
{{Note|Don't forget to [[Log file#Enable Debugging|'''Enable Debugging''']] when creating the log so that maximum detail is available}}<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> | |||
}} | }} | ||
Line 71: | Line 70: | ||
The installation paths are as below: | The installation paths are as below: | ||
<source lang="bash">/usr/share/xbmc/ | |||
/usr/lib/xbmc/</source><br /> | |||
< | |||
{{Note|No user XBMC configuration files are kept in these locations; refer to [[userdata]] for these.}} | |||
}} | }} | ||
Line 114: | Line 112: | ||
}} | }} | ||
== Troubleshooting == | |} | ||
=== Boot | |||
== Troubleshooting: General == | |||
{| width="100%" | |||
{{FAQ|1= BootIssues | |||
| BGcolor= | |||
| Question= Boot Issues | |||
| Answer = | |||
Some Intel GPUs 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> | ||
Append '''i915.i915_enable_rc6=0''' to: | Append '''i915.i915_enable_rc6=0''' to: | ||
Line 127: | Line 131: | ||
;Then run | ;Then run | ||
<source lang="bash">sudo update-grub</source> | <source lang="bash">$ sudo update-grub</source> | ||
== | }} | ||
{{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 | |||
== Troubleshooting: Video == | |||
:{{incomplete}} | |||
:Most of the problems that you encounter with slow display, playback or OpenGL related errors on Linux are because you do not have the proper display drivers installed, or because your versions are outdated. Using the correct drivers or updating can be a decisive step in resolving some issues. | |||
{| width="100%" | |||
=== | {{FAQ|1= InstallOnUbuntu | ||
| BGcolor= | |||
| Question= Installing video drivers on Ubuntu and derivatives | |||
| Answer = | |||
:* For '''NVIDIA''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/Nvidia click this (link)] | :* 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 '''ATI''' drivers follow the guide [https://help.ubuntu.com/community/BinaryDriverHowto/ATI click this (link)] | ||
Line 139: | Line 151: | ||
: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, you can find forum discussions on various relevant topics, including complete setups and configuration of drivers. '''No | 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 ?]]}} | ||
{{forum link2|[[forum:116996|XVBA for AMD Radeon/Fusion/NVidia 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 /> | {{forum link2|[[forum:114368|Intel GPU forum discussion thread]]}}<br /> | ||
}} | |||
=== Upgrading | {{FAQ|1= UpgradingNVIDIA | ||
| BGcolor= WhiteSmoke | |||
Make sure that old versions of the | | Question= Upgrading NVIDIA drivers on Ubuntu and derivatives | ||
| Answer = | |||
Ubuntu (including XBMCbuntu) often ships with outdated drivers that do not fully support a platform. | |||
Make sure that old versions of the NVIDIA drivers are removed if you use other third-party PPAs (repositories). For the sake of your sanity, '''don't remove any Ubuntu sources''', as that is highly likely to break something. | |||
<source lang="bash"> | <source lang="bash"> | ||
sudo apt-get install python-software-properties pkg-config | $ 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 -r ppa:the_3rd_party_ppa_you_wish_to_remove_here | ||
sudo add-apt-repository ppa:ubuntu-x-swat/x-updates | $ sudo add-apt-repository ppa:ubuntu-x-swat/x-updates | ||
apt-get update | $ apt-get update | ||
sudo apt-get install nvidia-current nvidia-settings | $ sudo apt-get install nvidia-current nvidia-settings | ||
</source><br /> | </source><br /> | ||
{{forum link2|[[forum:142220|NVidia Drivers updates XBMCBuntu, Ubuntu and variants forum discussion thread]]}}<br /> | {{forum link2|[[forum:142220|NVidia Drivers updates XBMCBuntu, Ubuntu and variants forum discussion thread]]}}<br /> | ||
}} | |||
=== Intel SNA Acceleration | {{FAQ|1= IntelSNA | ||
| BGcolor= | |||
| Question= Intel SNA Acceleration | |||
| Answer = | |||
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. | ||
The use of GPU acceleration is an essential part of getting both smooth video playback and a lag-free interface (GUI). | 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. | ||
< | <source lang="xml">Section "Device" | ||
Identifier "Intel Graphics" | Identifier "Intel Graphics" | ||
Driver "intel" | Driver "intel" | ||
Option "AccelMethod" "sna" | Option "AccelMethod" "sna" | ||
EndSection</ | EndSection</source> | ||
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'''] | 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]]}} | ||
}} | |||
=== Verify OpenGL | {{FAQ|1= VerifyOpenGL | ||
| BGcolor= WhiteSmoke | |||
| Question= Verify OpenGL Support | |||
| Answer = | |||
Once you have your drivers in place, you need to make sure that OpenGL is properly configured. Run the following command: | |||
<source lang="bash"> | <source lang="bash"> | ||
Line 181: | Line 205: | ||
</source> | </source> | ||
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. | |||
}} | |||
{{FAQ|1= Compiz | |||
| BGcolor= | |||
| Question= Compiz is not compatible with XBMC | |||
| Answer = | |||
There are several ways to address this. | |||
* Make sure Compiz visual effects are 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, you can disable this in xorg.conf, like so: | |||
:<syntaxhighlight lang="xml" enclose="div"> | |||
Section "Extensions" | |||
Option "Composite" "Disable" | |||
EndSection | |||
</syntaxhighlight> | |||
* Or, again for NVIDIA, you can disable Compiz directly at a terminal prompt: | |||
:<source lang="bash">$ sudo nvidia-xconfig --no-composite</source> | |||
Example minimal xorg.conf for NVIDIA: [[Minimal NVidia xorg.conf]] | |||
}} | |||
|} | |||
== Troubleshooting: Audio == | |||
{| width="100%" | |||
=== 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 == | |||
{| width="100%" | |||
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]]}} | |||
|} | |||
== Updating XBMC from PPA == | |||
{| width="100%" | |||
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. | 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. | ||
Line 207: | Line 298: | ||
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'''. | 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 | Connect to your Debian/Ubuntu-based system via [[SSH]] and run the commands below: | ||
<source lang="bash"> | <source lang="bash"> | ||
Line 225: | Line 316: | ||
:Upgrading XBMC in FreeBSD is pretty simple, as long as a new version exists in port | :Upgrading XBMC in FreeBSD is pretty simple, as long as a new version exists in port | ||
; Update | ; Update your port tree: | ||
<pre>portsnap fetch update</pre> | <pre>portsnap fetch update</pre> | ||
; Update XBMC: | ; Update XBMC: | ||
Line 232: | Line 323: | ||
==== Gentoo manual XBMC upgrade process ==== | ==== Gentoo manual XBMC upgrade process ==== | ||
This part needs to be updated <big>'''?'''</big> | This part needs to be updated <big>'''?'''</big> | ||
|} | |||
== Known issues == | == Known issues == | ||
{| width="100%" | |||
'''''See:''''' [[XBMC v12 (Frodo) issues]] | '''''See:''''' [[XBMC v12 (Frodo) issues]] | ||
|} | |||
[[Category:XBMC Manual]] | [[Category:XBMC Manual]] |
Revision as of 13:39, 2 February 2014
General topics Devices |
FAQs Linux |
Linux FAQ |
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
Caveat
- There are no official XBMC builds for Linux distributions other than Ubuntu yet. If you use something other than Ubuntu, check to see if XBMC is available via your repositories or normal software installation method.
- See also: Installing XBMC for Linux for how to install XBMC on other distributions.
General FAQ
- See also: XBMC all platforms FAQ for FAQs that apply to all versions of XBMC.
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||
|
Troubleshooting: General
|
Troubleshooting: Video
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, playback or OpenGL related errors on Linux are because you do not have the proper display drivers installed, or because your versions are outdated. Using the correct drivers or updating can be a decisive step in resolving some issues.
| ||||||||||
| ||||||||||
| ||||||||||
| ||||||||||
|
Troubleshooting: Audio
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.
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.
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.
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.Setting up dual audio forum discussion thread |
Updating XBMC from 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
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 system 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 your port tree
portsnap fetch update
- Update XBMC
portmaster multimedia/xbmc
Gentoo manual XBMC upgrade process
This part needs to be updated ?