Archive:HOW-TO:Install XBMC for Linux on Fedora using a Shuttle XS35GTv2

This page is a work in progress - Bare with me, it'll improve over the next few days!

Hardware used

Shuttle XS35GTv2 - This guide should suit for any atom / ION2 based PC, though the HDMI audio may differ.
VGA monitor (for initial setup - It'll be easier due to some GUI issues like font size)
HDMI capable TV / receiver (receiver is optional, necessary for passthrough options and nothing else)
Keyboard and Mouse (USB or bluetooth, bluetooth recommended if you need it for the long term (if you dont have a remote device (android, etc) or an IR receiver and compatible remote)

Software used

Fedora 15 DVD x64 - Download from Fedora Project website

Installing hardware

RAM

I used Corsair 4gb DDR3 SO-DIMM.
1. Open the case by removing the screw under the rubber cover and sliding off the cover.
2. Slot the memory into the slot at a 45 degree angle.
3. Press down to clip the RAM in
4. Install the HDD while your at it! See below

HDD

I used an OCZ 60gb Vertex 2 SSD. Make sure your drive is 2.5 inch!
1. Open the case as above
2. Screw the HDD bracket onto the hard drive. Make sure you do the screws up tight enough so the drive cant move
3. Plug the HDD onto the board
4. Screw the bracket down into the Shuttle itself.

Installing Fedora

Starting out

1. Burn the ISO to a blank DVD, or use a thumbdrive to create a bootable USB stick.
2. Boot to the device. If you have never checked the image, scan it now.
3. The installer will start up and should start a GUI.
4. Select your language and Keyboard type.
5. Select Basic Storage.
6. Type a hostname for your PC.
7. Select your timezone, and if the PC is not dual-booting another OS, tick System Clock uses UTC.
8. Type a root password. This should be a very secure password as it grants administrator permission for the PC.

Setting up the partitions

Here you can make a choice, go with what the installer thinks is best, or customise. I will run through the process of customising as i like a simple clean layout. If you choose to use what the installer wants, just resume reading where relevant.
1. Select Create Custom Layout
2. Delete any existing partitions (sdaX) by selecting and pressing Delete. Alternatively just select sda and press delete to clear them all.
3. Create a new partition for swap by selecting free, then pressing create. Choose Standard partition.
4. Leave Mount point blank, choose File system type SWAP, and set size to 2x your RAM (in MB) and press OK.
5. Create a new partition for the filesystem by selecting free again, and pressing create. Choose Standard again.
6. Set Mount Point to /, file system type to ext4, set to Fill to maximum allowable size, and tick force to be primary. Press ok.
7. Ensure your sda1 is the bulk of the drive, and that sda2 is swap. If not, repeat the process.
8. Press next, and confirm the changes to disk.
9. Leave the boot loader on /dev/sda, and just press next on teh boot loader options screen.

Package selection

This is where you choose what gets installed with Fedora. Most things can be installed afterwards (using yum) but some things are simpler if done here.
1. Set to Graphical Desktop, leave the repos as is (Installation repo) and press "Customise now"
2. Under Desktop environments, select GNOME, and KDE.
3. Under Languages, select what you need (i use English UK as I'm from Australia, and it must be chosen here to have it available)
4. Press Next, the installer will do some work to check everything is ok and will proceed installing.

First Boot

Once the installer finishes there are a few final items to attend to. I will be using KDE for the rest of this guide.
1. Once the installer completes, the disc will eject. Remove the disc / thumbdrive and press Reboot.
2. The PC will reboot out of the installer and boot into Fedora itself. This will take a little while the first time.
3. Fedora will display the firstboot configuration menu once booted. Press forward to proceed.
4. Press forward on the license page to begin user creation.
5. Create your user by filling in Full name, username and password. Tick Add to administrators Group, then press forward to continue.
6. Select sychronise date and time over the network if you want to use internet time (recommended). Otherwise set the clock. If your using NTP the default servers should be fine (unless you have a local one you want to specify)
7. Turn on Send Profile if you want to (there is an explanation at the top of what this does).
8. Press submit to finish firstboot and drop into GDM (login manager)
9. Click on your user, but DO NOT type your password.
10. Change GNOME to KDE Plasma Workspace, then type your password and press Log In.

Setting up KDE / KDM / AutoLogin

Once you have logged into KDE, there are some cleanup items to complete to ensure autologin etc happens without problems.
I recommend removing the plasma widget on the desktop (hover over it and a little menu pops up). Its just unnecessary clutter.

Setting KDM as the login manager

By default, Fedora using GDM (GNOME's login manager) to handle logins. KDE login configuration expects KDM to be used, so we need to set KDM to be the default.
1. Start a console session by right clicking on the background and choosing Konsole
2. Log in as root by typing su -, pressing Enter, and typing your root password.
3. type "cd /etc/sysconfig" to switch to the correct path (folder)
4. type "echo DISPLAYMANAGER=KDE > desktop" to create the file called desktop, and fill it with that line.
5. exit your terminal by typing exit (to get out of root login) and then exit again (to exit the terminal)

Setting up KDM

1. Go to Kickoff (the fedora logo at the bottom, and go into System settings.
2. At the bottom, select Login Screen.
3. On the convenience page, enable Password-Less login, and selet your user as well
4. Tick the "Automatically log in again after X server crash" to ensure auto-login will happen no matter what
5. Press OK, and type your user password to confirm authority to change.
6. Close the configuration window, and restart (Restart, shutdown etc are in kickoff as well)

Setting up Auto-Login

1. When the system restarts, you should be in KDM. It will have the same background as KDE did.
2. Type your username, then press Session Type.
3. Select KDE Plasma workspace, then type your password and press enter to log in.
4. Open the login screen configuration again by following steps 1 and 2 in KDM setup.
5. On the Convenience tab, select Enable Auto-Login, and choose your user in the drop-down.
6. Press apply, and type your password to confirm. 18. Reboot one more time, and ensure auto-login works correctly and into KDE.

Setting up the Network

Option 1 - Using NetworkManager

This will result in the network interface not starting until your GUI (KDE) has at least partially loaded. For XBMC though that will be fine, and its also easy and quick. You also get the benefit of easy wireless configuration etc.
This guide focuses on wired network connections, as thats what im using at the moment, however wireless connections are very easy, and similar to windows etc anyway.
1. In the system tray in the bottom right, you will see NetworkManager. It may look like a network plug, a network port, or a wireless logo.
2. Left click on it, then press "Manage Connections"
3. In the window that opens, ensure you are on the "Wired" tab, and press Add.
4. Give the connection a name at the top. Im setting it up for Automatic (DHCP), so I usually call it Auto Eth0.
5. Tick the "Connect automatically" box to ensure this will happen everytime KDE starts.
6a. If you just want DHCP, you can press OK now. 6b. If you want to specify IP etc, you can do so below. Ensure you change the method to the appropriate option. Press OK once complete.
7. Press Apply, then OK on NetworkManager's main configuration window.
8. If you have the cable plugged in, your connection should now activate, and you should have network.

Option 2 - Manually

This option requires you to disable NetworkManager (with service NetworkManager stop and chkconfig NetworkManager off) and then set up your network interfaces manually. Its not completely practical for wireless connections, but for wired connections it is not hard, but its un-necessary work. Anybody who feels its worth it can fill this section in, otherwise i may do it later.

Setting up RPMFusion

RPMFusion has good instructions for setup available on their website at http://www.rpmfusion.org/Configuration
I wont duplicate their instructions, but i highly recommend using the command line, and running their Command line setup via YUM. The command given will require your root password to work.

Fixing various issues with NVIDIA drivers and HDMI out

Boot screen fix

This setting is for 1080p displays, and will present the fedora bootscreen in 1080p resolution, with an image that fills 80% of the screen. Other resolutions can be found by adding ask (i think) into this vga= and choosing the one that is appropriate to you.
1. On the command line, (terminal window or console) log in to root (su -)
2. Change directory to /boot/grub/
3. Inside your grub.conf file add the following to the end of any of the kernel lines: vga=0x34d
4. Save the file, and reboot
Next time you reboot you should get the Fedora graphical bootscreen (F logo filling up) rather than the 3 bars.

Font DPI (KDE GUI)

This issue seems to present itself on TV's and not monitors, even if the resolution matches. I recommend forcing it even if you are not having problems. The issue presented as very small fonts and normal images to me, whereas a friend had extra large font and small images. In both cases this fix made it normal again.
1. In Kickoff, go into System Settings.
2. At the top, open the second item (Application Appearance)
3. Go to the fonts item on the sidebar.
4. Change "Force fonts DPI" to 96 DPI.
5. Press Apply at the bottom. Items will be fixed as they are started / restarted. To resolve all problems restart the PC.

Font DPI (KDM / Xorg setting)

This issue will only be seen when in the login manager is used, which given the above setup should never happen. I believe you need to force the DPI within the xorg.conf file, but i have not done this on this PC (and dont intend do). Anybody wishing to do this should google "xorg.conf 96 DPI force nvidia", please update this wiki if you do :)

Installing XBMC (the easy / lazy way)

Now that you have set up your network and RPMFusion, you can install XBMC the easy way. RPMFusion provides pre-built packages for XBMC that work on 64bit installs, i have not tested 32bit but they should be available too.

Installing XBMC

1. Open a console (right click on the desktop and press Konsole)
2. Log in as root (or use sudo in front of the next command and use your password)
3. Run the following command "yum install xbmc", and press yes or y on any relevant questions
4. Once the install completes xbmc will be installed and available, but we still need to link it on your kickoff favourites and set it up for autostart.

Setting it as a favourite applcation

1. Open Kickoff.
2. Type XBMC media in the search box at the top.
3. Right click on xbmc, and press Add to Favourites.
4. XBMC will now appear on the first page of kickoff for ease of access.

Setting up XBMC to run on KDE startup

1. In Kickoff, click on system settings.
2. At the bottom right, click on Startup and Shutdown.
3. Under autostart, press "Add Program"
4. type xbmc, and press ok. Press OK again to confirm the label etc.
5. Close the system settings, the next time the PC boots it will autostart XBMC

Getting HDMI sound working

Option 1 - With passthrough bitstreaming but no OS / Menu sounds

Direct to HDMI audio source from xbmc
1. Unmute the HDMI channels using alsamixer (on the command line). You will see 4 channels under HDMI, press M to unmute them all
2. inside XBMC, set the audio device and passthrough device to custom, and enter plughw:1,7 3. Sound should now work within all media. No menu sounds or OS sound will be available (as this seems to inherit from the OS sound method, rather than the selected options)

Option 2 - With OS / Menu sounds, but no passthrough bitstreaming

Via the OS sound system (PulseAudio)

Option 3 - Remove PulseAudio for the OS and move back to ALSA

Not recommended or tested, but if you have done this, document it here!
I recommend not trying this unless you have already done it, pulseaudio recently completed a bug report to patch this passthrough problem, and assuming packages make their way downstream soon enough, passthrough for bitstream should not be a problem any longer.

Activating 1080/24hz

Coming soon - This should need to be done in xorg.conf.

Using an external IR receiver

The receiver this is written for is the HP IR receiver for Media Center. Your experience with others will vary.

I have tested this receiver, out of the box it does not appear to be working with Fedora, I have confirmation it does however work on Windows 7 and XBMC.

I will do further investigation and report how to make it work, but for the moment dont place any bets....