Archive:HOW-TO:Install XBMC on Ubuntu/HOW-TO 1

From XBMC
Revision as of 18:06, 20 March 2009 by D4rk (Talk)

Jump to: navigation, search

The purpose of this guide is to give a hand to new XBMC users, who want to build a Linux based, dedicated HTPC (Home Theater PC), a true living-room media center computer, but don't have any knowledge and experience in the Linux world.

You always have the chance to try XBMC Live to test/demo XBMC Media Center, but if you want to have more control and more customization possibilities, than a Linux installation like in this guide is more suitable.

Contents

1 Introduction

This is a real step-by-step guide, I hope everybody can follow and walk through the whole installation procedure. The guide is based on either Ubuntu 8.04 (Hardy Heron) or 8.10 (Intrepid Ibex) as a platform, start with a minimal install and only install the needed components at the top of that.

On the face of it, maybe seems very lengthy process, but you will feel shorter while you follow it.

Please note:

  • The guide is for using XBMC on a dedicated HTPC, so there is no window manager and/ or any additional applications installed.
  • You need minimum 4GB size Flash drive or harddisk drive to install on.
  • Since you will use this PC only as a media center. I therefor assume that you use digital audio pass-through (S/PDIF or HDMI) to a receiver/amplifier with built-in Dolby Digital (AC3) decoder, and hence I choose NOT to install the dependency libraries for PulseAudio and compile XBMC later without PulseAudio support.

You will get:

  • A dedicated HTPC which auto-boots directly to XBMC Media Center.
  • Latest XBMC SVN version.
  • Updated ALSA (audio) driver.
  • Updated VIDEO (graphics) driver.
  • LIRC (Microsoft MCE Remote will work out-of-the-box, however if you have any other remotes and/or LCD displays then you are on your own to solve the individual LIRC and LCDproc issues).
  • Suspend/resume (works perfectly on for example ASUS P5N7A-VM motherboard with Intrepid).

Known issues:

  • Installations based on Intrepid having some performance issues, due to unidetified reason. You can read more on that here.
  • You might have some difficulties with suspend/ resume on Hardy based installation

2 Preparation

FIRST STEP

Download and burn Ubuntu Hardy or Intrepid mini.iso (according to your platform preference) from here:
https://help.ubuntu.com/community/Installation/MinimalCD

Please be aware, if you are installing a full Ubuntu system with GDM, then the guide will not fully work!

Now perform a default install.

  • When asked during the installation, please set „xbmc” as username and password at the account creation.
  • At the end, when you have to choose from the optional components, check only „OpenSSH” to be able to access your HTPC remotely via SSH.

Apparently there seems to be an issue with Intrepid installer. If you are using flash drive, it's not installing GRUB for some reason.
This is only affect Intrepid, and only when you are installing it onto a flash drive.

To handle this, you have to options:

  1. Either install Hardy(Ubuntu 8.04) mini.iso first, which is installing GRUB correctly, then right after that, install Intrepid mini.iso over the same flash drive. It will reformat the drive, but GRUB will stay alive on the drive.
  2. Second option is that right after Intrepid mini installation, boot up Intrepid mini.iso from the CD again, choose rescue mode, and there you will find an "install GRUB" option.

After you’ve done, boot it up, then use an SSH application (e.g. putty) to log in remotely from your desktop, using the above created username and password. This way, you will be able to copy/ paste all the steps below. Alternatively you can use console on the htpc too, but then you will have a hard time type in everything.

So once you logged in:


First of all, update the repositories, and install all prerequisites:

NEXT STEP

# sudo apt-get update

NEXT STEP Hardy - Skip this and jump to NEXT STEP Intrepid, if you are installing Intepid

# sudo apt-get --purge autoremove -y nvidia-kernel-common linux-restricted-modules-generic linux-restricted-modules-common linux-restricted-modules-2.6.24-23-generic

NEXT STEP Hardy - Skip this and jump to NEXT STEP Intrepid, if you are installing Intepid

# sudo apt-get install -y linux-headers-generic localepurge subversion make g++ gcc gawk pmount libtool nasm automake cmake gperf unzip bison libsdl1.2-dev libsdl-image1.2-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libsdl-sound1.2-dev libsdl-stretch-dev libfribidi-dev liblzo-dev libfreetype6-dev libsqlite3-dev libogg-dev libasound-dev python-sqlite libglew-dev libcurl4-gnutls-dev x11proto-xinerama-dev libxinerama-dev libxrandr-dev libxrender-dev libmad0-dev libtre-dev libogg-dev libvorbis-dev libmysqlclient15-dev libpcre3-dev libdbus-1-dev libhal-dev libhal-storage-dev libjasper-dev libfontconfig-dev libbz2-dev libboost-dev libfaac-dev libenca-dev libxt-dev libxmu-dev libpng12-dev libjpeg-dev mesa-utils wget zip curl hal build-essential linux-headers-`uname -r` xorg pm-utils

NEXT STEP Intrepid

# sudo apt-get install -y localepurge subversion make g++ gcc gawk pmount libtool nasm automake cmake gperf unzip bison libsdl1.2-dev libsdl-image1.2-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libsdl-sound1.2-dev libsdl-stretch-dev libfribidi-dev liblzo-dev libfreetype6-dev libsqlite3-dev libogg-dev libasound-dev python-sqlite libglew-dev libcurl4-gnutls-dev x11proto-xinerama-dev libxinerama-dev libxrandr-dev libxrender-dev libmad0-dev libtre-dev libogg-dev libvorbis-dev libmysqlclient-dev libpcre3-dev libdbus-1-dev libhal-dev libhal-storage-dev libjasper-dev libfontconfig-dev libbz2-dev libboost-dev libfaac-dev libenca-dev libxt-dev libxmu-dev libpng12-dev libjpeg-dev mesa-utils wget zip curl build-essential linux-headers-`uname -r` xorg pm-utils

During the installation of the packages, there will be a popup window to choose your locale languages to let "localepurge" know which locales not to remove in further installations. I would suggest to keep all en_us (3 all together) and your own country locales (again should be 3) as well. Localepurge will save you some space with removing unneccessary languages.

3 Upgrading ALSA (sound driver) to the latest version

I have modified the ALSA upgrade script (available at Ubuntuforums), and now it is working with only “-di” option in our case here (Also on ASUS P5N7A-VM).

To download and use the script:

NEXT STEP

# wget http://217.20.138.65/xbmc/AlsaUpgrade-1.0.x-rev-1.16.sh

NEXT STEP

# chmod a+x AlsaUpgrade-1.0.x-rev-1.16.sh


NEXT STEP

# sudo ./AlsaUpgrade-1.0.x-rev-1.16.sh -di

If you are on Intrepid, you have to add the user created at installation to the „audio” group (you don't need to do that in case of Hardy).

NEXT STEP

# sudo usermod -a -G audio xbmc 

(Please note: replace „xbmc” with username you installed with)


You also have to edit the following file to make spdif and/or hdmi work properly:

NEXT STEP

# sudo nano /etc/modprobe.d/alsa-base

and add this line to the end:

options snd-hda-intel model=6stack-dig


reboot the computer:

NEXT STEP

# sudo reboot

For some reason, the driver snapshot for ALSA 1.0.19 is not always downloading properly; in this case you have to run the script again. To check whether the driver upgraded or not:

NEXT STEP

# more /proc/asound/version

If you see driver version 1.0.19 here, you can continue, but it's shows 1.0.17 as driver version, then you have to repeat the last 3 step (upgrade, reboot, check).

If it’s OK, then you can delete the just downloaded ALSA source to free up some disk space:

NEXT STEP

# sudo rm -r /usr/src/Alsa-1.0.19/

Now run alsamixer:

NEXT STEP

# alsamixer

Navigate right with cursor keys until IEC958 and unmute all three of them (IEC958) with „M” key. You should see in case of all three IEC958 a „00” in green background. Press „ESC” to quit from alsamixer.

4 Update Video driver

4.1 Nvidia

(For Ati owners: jump to #Ati)

NEXT STEP

# wget ftp://download.nvidia.com/XFree86/Linux-x86/180.37/NVIDIA-Linux-x86-180.37-pkg1.run

NEXT STEP

# sudo sh NVIDIA-Linux-x86-180.37-pkg1.run

In the nvidia installer: accept the License agreement, choose „YES” for „No precompiled kernel interface...”, choose „OK” for „No matching precompiled kernel interface...”, than choose „YES” to update X configuration file, than finally „OK” again at the end.

Now you can delete Nvidia installer:

NEXT STEP

# rm NVIDIA-Linux-x86-180.37-pkg1.run

4.1.1 xorg.conf configuration (Nvidia)

If you want your Xorg autodetect the native resolutions from EDID and want to use 24p you have to replace your xorg.conf with this (not guaranteed to work, but should with newer Nvidia cards):

NEXT STEP

# sudo cp /etc/X11/xorg.conf /etc/X11/xorg.conf.backup

NEXT STEP

# sudo wget http://217.20.138.65/xbmc/xorg.conf -O /etc/X11/xorg.conf

(To continue click on: #Download, compile, and install XBMC from source (skip section Ati))


4.2 Ati

NEXT STEP

# sudo apt-get install -y cdbs fakeroot dh-make debhelper debconf libstdc++5 dkms

NEXT STEP

# wget http://www2.ati.com/drivers/linux/ati-driver-installer-8-12-x86.x86_64.run

NEXT STEP

# sudo sh ati-driver-installer-8-12-x86.x86_64.run --buildpkg Ubuntu/intrepid

NEXT STEP

# sudo dpkg -i xorg-driver-fglrx_8.561-0ubuntu1_i386.deb fglrx-kernel-source_8.561-0ubuntu1_i386.deb fglrx-amdcccle_8.561-0ubuntu1_i386.deb

NEXT STEP

# rm ati-driver-installer-8-12-x86.x86_64.run  *.deb

4.2.1 xorg.conf configuration (Ati)

Will be discussed later, stay tuned


5 Download, compile, and install XBMC from source

NEXT STEP - This is the main trunk, skip to the following step, if you want to use vdpau

# svn checkout https://xbmc.svn.sourceforge.net/svnroot/xbmc/branches/linuxport/XBMC

In case of Hardy, you will get a certificate warning, accept it permanetly by pressing „P”. Wait for downloading XBMC source files, might takes long time, depend on your Internet connection.

OPTIONAL STEP - In case you want to use vdpau branch, skip if you choosed the main trunk
You have to have vdpau compatible VGA vard for this with 512MB video ram at least!

# svn checkout https://xbmc.svn.sourceforge.net/svnroot/xbmc/branches/xbmc-vdpau/XBMC

In case of Hardy, you will get a certificate warning, accept it permanetly by pressing „P”. Wait for downloading XBMC source files, might takes long time, depend on your Internet connection.

NEXT STEP

# cd XBMC

Then configure, compile, and install XBMC:

NEXT STEP

# ./configure --prefix=/usr --disable-pulse

NEXT STEP

# make -j2 (Please note: use only „make”, if you don’t have a dualcore CPU)

This is again, can take quite some time, depending on your CPU speed.

NEXT STEP

# sudo make install


6 Autoboot to XBMC

WARNING!!! Do NOT follow this section unless you understand what EVERY step is actually doing. The original author hasn't thoroughly explained each step. If something goes wrong you WILL NOT be able to easily get to a normal desktop, so if you aren't 100% comfortable with recovering any and all issues in Linux from the command line, THINK TWICE!!! You can easily setup gdm to auto login and gnome to autostart XBMC.

NEXT STEP

# sudo wget http://217.20.138.65/xbmc/xbmc -O /etc/init.d/xbmc

NEXT STEP

# sudo chmod a+x /etc/init.d/xbmc

NEXT STEP

# sudo update-rc.d -f xbmc defaults

NEXT STEP

# sudo wget http://217.20.138.65/xbmc/runXBMC.sh -O /usr/bin/runXBMC.sh

If you not choosed "xbmc" as your user at the installation, you have to modify this file according to your username.

NEXT STEP

# sudo chmod a+x /usr/bin/runXBMC.sh

NEXT STEP

# sudo wget http://217.20.138.65/xbmc/setAlsaVolumes.py -O /usr/bin/setAlsaVolumes.py

NEXT STEP

# sudo chmod a+x /usr/bin/setAlsaVolumes.py

NEXT STEP

# sudo dpkg-reconfigure x11-common

And choose "anyone" to run X. Leave the other question on default.


7 Install Lirc

I've found MS MCE Remotes, listed here: http://www.mythtv.org/wiki/MCE_Remote, are plug & plays, working out of the box. I also found, that there're remotes out there, which instalation are a real pain. The choise is yours. If you have one of the above mentioned MS MCE remotes, the installation is that simple:

NEXT STEP

# sudo apt-get install -y lirc

And follow the wizard.


8 Power Management

To be able to control power management (suspend, shutdown, reboot) from within XBMC, you have to modify PolicyKit.conf to grant privilegies to your user for power management. There is a preprepared PolicyKit.conf for this, you can get it by:

NEXT STEP

# sudo wget http://217.20.138.65/xbmc/PolicyKit.conf -O /etc/PolicyKit/PolicyKit.conf

Please note: if you installed your system with username other than "xbmc" at the begining, you have to modify that in the file.


If you wish to enable CPU scaling, install the required packages as the following, but don’t forget to enable it in the BIOS as well.

NEXT STEP

# sudo apt-get install powernowd


9 Install Splash

You may want to have a look at du-duke's fantastique splash screens. You can check these here: http://du-duke.blogspot.com/ You can download your choice below.

NEXT STEP

# sudo apt-get -y install usplash libusplash-dev

NEXT STEP Hardy - Skip this and jump to NEXT STEP Intrepid, if you are installing Intepid

# sudo apt-get -y install usplash-theme-ubuntu

NEXT STEP Hardy - Skip this and jump to NEXT STEP Intrepid, if you are installing Intepid
CHOICE 1 - Downloading spinner-blue

# sudo wget http://217.20.138.65/xbmc/splash/usplash-spinner-hardy.so -O /usr/lib/usplash/usplash-theme-ubuntu.so

NEXT STEP Hardy - Skip this and jump to NEXT STEP Intrepid, if you are installing Intepid
CHOICE 2 - Downloading pulsating-logo

# sudo wget http://217.20.138.65/xbmc/splash/usplash-pulsating-hardy.so -O /usr/lib/usplash/usplash-theme-ubuntu.so

NEXT STEP Intrepid
CHOICE 1 - Downloading spinner-blue

# sudo wget http://217.20.138.65/xbmc/splash/usplash-spinner-intrepid.so -O /usr/lib/usplash/usplash-theme-ubuntu.so

NEXT STEP Intrepid
CHOICE 2 - Downloading pulsating-logo

# sudo wget http://217.20.138.65/xbmc/splash/usplash-pulsating-intrepid.so -O /usr/lib/usplash/usplash-theme-ubuntu.so

NEXT STEP

# sudo nano /etc/usplash.conf

and set your desired splash resolution, so inserting the following to here. (Please note: this is a FullHD example):

xres=1920
yres=1080

NEXT STEP

# sudo update-initramfs -u


10 Enable thermal monitoring

To install the necessary package:

# sudo apt-get install -y lm-sensors

Once lm-sensors installed, you have to run sensor detection to identify your sensors:

# sudo sensors-detect

There will be a lot of questions here, but you can answer by "enter" key to all of them, except the last question. So answer "enter" to all questions, until you see the the question "Do you want to add these lines automatically?" At here, you have to type "yes", then enter.

Reboot the computer:

# sudo reboot

After rebooted, check if the sensors are working:

# sensors -u

You should see the output of the sensors here.

10.1 XBMC CPU temp detection

To let XBMC detect your CPU temps provided by lm-sensors, you have to edit your advancedsettings.xml and insert the following:

<advancedsettings>
<cputempcommand>echo "$(sensors | grep "Core 0" | sed -e 's/[a-z]*..............\([0-9].\)\..*/\1/') C"</cputempcommand>
</advancedsettings>


10.2 XBMC GPU (nvidia) temp detection

To let XBMC detect your GPU temps provided by nvidia-settings, you have to edit your advancedsettings.xml and insert the following:

<advancedsettings>
<gputempcommand>echo "$(nvidia-settings -tq gpuCoreTemp) C"</gputempcommand>
</advancedsettings>



11 Enable eject button of your ODD

# sudo nano /etc/sysctl.conf

and uncomment (by deleting # from the begining of the line) the last line, so it will look like this:

dev.cdrom.lock=0


12 Reduce boot time

reduce GRUB waiting (~2 sec)

# sudo nano /boot/grub/menu.lst

Find the timeout (currently set to 3) and change this to 0


reduce the number of loaded vts (virtual terminal service)

By default, there're F1 through F7, we don't need that much for a HTPC, so we can remove most of them.

# sudo nano /etc/event.d/tty3

and comment out all the lines, using #. Repeat the above command for tty4-tty6, so at the end you've deactivated 3 vts's.


Enable concurrent booting (if you own a dual-core CPU)

# sudo nano /etc/init.d/rc

Find the line "CONCURRENCY=none" and change it to "CONCURRENCY=shell"


Disable unneccessary services
Install the necessary application

# sudo apt-get -y install sysv-rc-conf

And run it:

# sudo sysv-rc-conf

Navigate with your cursor keys, you can disable services by clearing X in each runlevel by "space" key.
You can disable the following services:

  • apparmor
  • dns-clean
  • fancontrol (unless you're using it)
  • pppd-dns
  • rsync


13 BIOS OEM Splash screen

Recent motherboards usually featured with the possibility to change to BIOS OEM logo. Below you can find a modified XBMC logo. The format and size of the picture has been modified to fit into the BIOS (ASUS P5N7A-VM), there is no guarantee to work with any other motherboard, but I guess it should work with all boards with newer AMI bioses.

BE AWARE! I take no responsibility if you brick your motherboard while playing with BIOS.

In case of ASUS, you can do it with MyLogo2, which is a bundled tool for your MB.

The aspect ratio of the picture is like this for purpose. When your BIOS displays it, it will stretch to fit to the screen. So this is made for 16:9 (not for 4:3, and nor for 16:10)

http://217.20.138.65/xbmc/pwrd_by_xbmc_bios_splash.bmp http://217.20.138.65/xbmc/Splash_oldFor16x9.bmp
Download1 Download2



14 Wake On Lan

# sudo apt-get install -y ethtool

# sudo nano /etc/init.d/wol.sh

Copy the following text into it, then save the file:

ethtool -s eth0 wol g


Make this newly created script executable:

# sudo chmod a+x /etc/init.d/wol.sh

Make it start during boot:

# sudo update-rc.d -f wol.sh defaults


15 Sound configuration in XBMC

After booted into XBMC switch to „digital” audio output, than choose the AC3 and DTS capabilities according to your receiver.


For SPDIF:
Leave audio output device: default
Leave passthrough to IEC958
Audio iec958 default 1.jpg

For HDMI:
Change audio output device to hdmi
Change passthrough to hdmi
Audio hdmi.jpg
(you will loose analog sound eg. navigation sound in case of hdmi)

16 MythTV

You may want to have a look at here:

http://wiki.xbmc.org/?title=MythTV

Personal tools
Namespaces

Variants
Actions
Google Search
Navigation
Wiki help
Toolbox