This page describes how to install XBMC on a Raspberry Pi running Raspbian. You can either install packages on an existing Raspbian installation, or you can download a prebuilt image and flash it to an SD card.
Installing packages on an existing installation
I've published a Debian archive containing packages for XBMC and some dependencies which it requires. This can be setup on an existing Raspbian installation (including the foundation image).
The easiest way to install the package is to add my archive to your system. To do this, store the
deb http://archive.mene.za.net/raspbian wheezy contrib
and import the archive signing key:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 5243CDED
Then update the package lists:
sudo apt-get update
You can then install it as you would with any other package, for example, with
sudo apt-get install xbmc
The user which you're going to run XBMC as needs to be a member of the following groups:
audio video input dialout plugdev tty
input group doesn't exist, you need to create it:
addgroup --system input
and setup some udev rules to grant it ownership of input devices (otherwise the keyboard won't work in XBMC), by placing the following in
SUBSYSTEM=="input", GROUP="input", MODE="0660"
KERNEL=="tty[0-9]*", GROUP="tty", MODE="0660"
To run XBMC, run
xbmc-standalone from a VT (i.e. not under X). XBMC accesses the display directly
and not via Xorg.
If you want XBMC to automatically start when the system boots, edit
/etc/default/xbmc and change
You also need to set the user which XBMC should run as (the
xbmc user is not automatically created
at the moment). Run
sudo service xbmc start to test this.
13.1-2: Link to libshairplay for better AirPlay support.
13.1-1: Gotham 13.1 release.
12.3-1: Frodo 12.3 release.
12.2-1: Frodo 12.2 release.
12.1-1: Frodo 12.1 release. Requires newer
libcec (also in my archive).
12.0-1: Frodo 12.0 release.
This build requires newer firmware than the raspberrypi.org archive or image contains. Either install the packages from the raspberrypi.org untested archive, the twolife archive or use (Not necessary as of 2013/02/11.)
12.0~git20130102.7a6cb7f-1: Frodo RC 3.
12.0~git20121219.74b907c-1: Frodo RC 2.
11.0~git20121114.25bb46a-1: Frodo Beta 1. This includes a database schema upgrade, so make sure to backup your userdata folder before upgrading.
11.0~git20121027.99da926-1: Fixes the issue of the last few seconds of video being cut off.
11.0~git20121018.ff434fe-1: Upgrading to this version will probably result in the GUI resolution being zoomed as described in this forum post. To fix this edit
userdata/guisettings.xml and remove the contents of the
11.0~git20120728.365953fb-4: Initial release
Flashing an SD card with a prebuilt image
I've built an image containing a Raspbian system with the XBMC packages which you can download
and flash to an SD card. You'll need a 1G SD card (which will be completely wiped).
Decompress the image using
% unxz raspbian-xbmc-20121029.img.xz
And then copy the image to the SD card device (make sure that you pick the correct device name!)
% sudo cp xbmc-20121029-1.img /dev/sdb
The image uses the same credentials as the foundation image, username "pi" and password "raspberry". You can use the
raspi-config tool to expand the root filesystem, enable overclocking, and various other configuration tasks.
Both Raspbian and XBMC can be updated using normal Debian mechanisms such as
# sudo apt-get update
# sudo apt-get dist-upgrade
I've started building packages for the upcoming Gotham release. These are in the new
unstable section of the archive. To install these packages update your source list to look like this:
deb http://archive.mene.za.net/raspbian wheezy contrib unstable
13.2~git20140719.6d3bb09-1: Gotham 13.2 Beta 2
13.1-1: Gotham 13.1
13.1~git20140525.4410736-1: Gotham 13.1 RC 1
13.0r2-1: Gotham 13.0 release
13.0~git20140426.2372235-1: Gotham RC 1
13.0~git20140418.482ccd3-1: Gotham Beta 4
13.0~git20140328.2dcc855-1: Gotham Beta 3 (same firmware requirements as Beta 2)
13.0~git20140315.a1cab7a-1: Gotham Beta 2 (this requires newer firmware, my archive includes packages as of 20140319)
13.0~git20140303.128426f-1: Gotham Beta 1
13.0~git20140218.6e16f0f-1: Gotham Nightly 2014/02/18
13.0~git20131231.8eb49b3-1: Gotham Alpha 11
13.0~git20131201.27834c6-1: Gotham Alpha 10
Trackback URL for this post: