XBMC for Raspberry Pi

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 Kodi/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 following in /etc/apt/sources.list.d/mene.list:

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 apt-get:

sudo apt-get install kodi

The user which you're going to run Kodi as needs to be a member of the following groups:

audio video input dialout plugdev tty

If the 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 Kodi), by placing the following in /etc/udev/rules.d/99-input.rules:

SUBSYSTEM=="input", GROUP="input", MODE="0660"
KERNEL=="tty[0-9]*", GROUP="tty", MODE="0660"

The GPU needs at least 96M of RAM in order for XBMC to run. To configure this add or change this line in /boot/config.txt:


You will need to reboot if you changed this value.


To run XBMC, run kodi-standalone from a VT (i.e. not under X). XBMC accesses the display directly and not via Xorg.

If you want Kodi to automatically start when the system boots, edit /etc/default/kodi and change ENABLED to 1:


Run sudo service kodi start to test this.

Release history

  • 15.2-2: Isengard 15.2 release, and most PVR addons.
  • 14.2-1: Helix 14.2 release.
  • 14.1-1: Helix 14.1 release.
  • 14.0-1: Helix 14.0 release.
  • 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 rpi-update. (Not necessary as of 2013/02/11.)

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

% 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 Kodi can be updated using normal Debian mechanisms such as apt-get:

# sudo apt-get update
# sudo apt-get dist-upgrade

Release history

Unstable versions

I've started building packages for the upcoming Jarvis 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

Release history

  • 16.1-1: Jarvis 16.1
  • 16.0-1: Jarvis 16.0
  • 16.0~git20151213.a724f29-1: Jarvis 16.0 Beta 4
  • 15.2-2: Isengard 15.2 with packaging changes to support PVR addons, and most PVR addons.
  • 15.2-1: Isengard 15.2
  • 15.1-1: Isengard 15.1
  • 15.0-1: Isengard 15.0
  • 15.0~git20150702.9ff25f8-1: Isengard 15.0 RC 1.
  • 15.0~git20150501.d1a2c33-1: Isengard 15.0 Beta 1.
  • 14.2-1: Helix 14.2 release.
  • 14.1-1: Helix 14.1 release.
  • 14.0-1: Helix 14.0 release.
  • 14.0~git20141203.35b4f38-1: Helix 14.0 RC 2
  • 14.0~git20141130.ea20b83-1: Helix 14.0 RC 1
  • 14.0~git20141125.4465fbf-1: Helix 14.0 Beta 5
  • 14.0~git20141124.ec361ca-1: Helix 14.0 Beta 4
  • 14.0~git20141116.88a9a44-1: Helix 14.0 Beta 3
  • 14.0~git20141103.d6947be-1: Helix 14.0 Beta 1. This requires firmware as of 2014/10/06 and libcec 2.2.0 (both included in the archive). There are also builds for Jessie but I haven't tested them. PVR addons are also updated.
  • 14.0~git20141002.d2a4ee9-1: Helix 14.0 Alpha 4

Trackback URL for this post:


Excellent guide - thank you very much!

I am really surprised and disappointed that we can't just 'apt-get install xbmc' using the official repositories. But it clearly doesn't work and your repo does so thank you for putting in the time and work to get it going and documenting it.

Kodi Beta 3

Beta 3 in the repo would be very nice. Thanks for your great work!

key server error

when trying to get the key - is that something temporary or what might be the issue here?

pi@raspberrypi ~ $ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 5243CDED Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --secret-keyring /tmp/tmp.BAtEaMEmW6 --trustdb-name /etc/apt//trustdb.gpg --keyring /etc/apt/trusted.gpg --primary-keyring /etc/apt/trusted.gpg --keyserver keyserver.ubuntu.com --recv-key 5243CDED gpg: requesting key 5243CDED from hkp server keyserver.ubuntu.com gpg: keyserver timed out gpg: keyserver receive failed: keyserver error

ok, but seems this is not a

ok, but seems this is not a show stopper as the packages can be installed without the key ...

Beta 2

can you add Beta 2 from Kodi, please?

Kodi 14 beta tar file

Hi Michael is it possible to get your kodi 14 beta in a tar file please?

kodi update segmentation fault

Hi mike I have just upgraded to kodi from your unstable repository and now when type kodi i get this error "Segmentation Fault (core Dumped)

######## Kodi CRASH LOG
########## SYSTEM INFO

Date: Mon Nov 10 14:25:34 GMT 2014 Kodi Options: Arch: armv6l Kernel: Linux 3.12.29+ #715 PREEMPT Sun Oct 12 12:54:22 BST 2014 Release: Raspbian GNU/Linux 7 (wheezy)

######### STACK TRACE

=====> Core file: /home/pi/core (2014-11-10 14:25:31.360880117 +0000) ========================================= [New LWP 2633] [Thread debugging using libthread_db enabled] Using host libthread_db library "/lib/arm-linux-gnueabihf/libthread_db.so.1". Core was generated by `/usr/lib/kodi/kodi.bin stand alone'. Program terminated with signal 11, Segmentation fault.

this the crash log hope you can help sorting this

I had the same error, I

I had the same error, I uninstalled pulseaudio and anything related to pulseaudio like pavucontrol, etc. and I solved it. I hope it helps.

I haven't seen any crashes

I haven't seen any crashes myself, and that crash log doesn't point to any culprits. Did you run apt-get dist-upgrade to update everything and reboot after updating? How much RAM is assigned to the GPU?

segmentation fault

Hi mike yes I ran apt-get dist-upgrade and rebooted I was using gpu 256 so i will try 128

Errors during updatating

I've been encountering 404 error when I tried to update, here you go:


Any clues how to solve it are more than welcome :)

The repo metadata wasn't

The repo metadata wasn't updated correctly, should be fixed now.


The Kodi PVR Addons in unstable are not working. They need to be changed to reflect the new Kodi paths.

Thanks for letting me know,

Thanks for letting me know, I'll take a look.

Banana Pi


Will it work in a Banana Pi with Raspbian installed?


The init script should have an option to start xbmc using xinit

For things like the Chrome Launcher plugin to work, it is necessary to have an X server running. To me, it seems that the easiest way to do this is via xinit. The xbmc init script should have an option to do that.

Installed on Raspbian/Debian

Hi I installed Kodi on my Rasbian system. It installed fine and runs but the PVR addons do not work specifically the MythTV addon. I have tried installing the mythtv addon but it does not configure/work in Kodi. Do you intent to release any further builds?

Cheers Spart

I haven't built new PVR

I haven't built new PVR addons yet, but am looking at that now.

I edited the file

I edited the file /etc/default/xbmc

to use "pi" instead of "xbmc" as user

I have this error:

pi@raspberrypi ~ $ xbmc-standalone Error: unable to open display :0 XBMC needs hardware accelerated OpenGL rendering. Install an appropriate graphics driver.

Please consult XBMC Wiki for supported hardware http://wiki.xbmc.org/?title=Supported_hardware Error: unable to open display :0 XBMC needs hardware accelerated OpenGL rendering. Install an appropriate graphics driver.

Please consult XBMC Wiki for supported hardware http://wiki.xbmc.org/?title=Supported_hardware Error: unable to open display :0 XBMC needs hardware accelerated OpenGL rendering. Install an appropriate graphics driver.

Please consult XBMC Wiki for supported hardware http://wiki.xbmc.org/?title=Supported_hardware XBMC has exited uncleanly 3 times in the last 2 seconds. Something is probably wrong

UI is bigger than screen and freezed

Hello everyone, I just performed all the steps on a fresh install Raspbian. Everything went well, but after booting XMBC (xmbc-standalone command) it seems that I have two issues:

1) image is to bigger than the screen (I tried to modify something one guy said below, but didn't worked) 2) Image seems to be freeze. I've plugged in a keyboard and mouse, but nothing seems to work.

Any thoughts?

Setting up alternative controller - XBMC remote and/or USBgamepa


Excellent binary source- I was up and running in no time. I have one little problem... I have no keyboard at the moment (just laptops). I've attempted to turn on the webserver controls manually (guisettings.xml) but the official XBMC remote can't find the XMBCpi server. I also have a USB SNES controller I use with RetroPie. I'd love if I could utilize it with XBMC. However, I can't tell if simple keymapping a keymap.xml will work for this (I suspect it will).

Any thoughts? Has anyone else had problems with the xbmc remote?

Anyone else using the snes usb controller for retropie here?

Thank you again!!

USB SNES controller & HDMI CEC

Hey, I was also looking into getting the USB SNES controller to work. However, it seems that joystick support is not compiled in. Is that true?

Also, I tried to get HDMI CEC working. The debug log shows the keypresses of my TV remote, and I created a corresponding keymap file, but it seems like the strokes do not get mapped to the XBMC functions. Any thoughts?

BTW, thank you very much for this great repository!

Remote working now, keyboard/mouse necessary Audio problems

Looks like I got the remote working now- it required keyboard/mouse to interface with the xbmc software. (borrow from a friend). I was surprised to see I couldn't edit the config files directly- I may have missed something (they were changed using sudo nano- but didn't matter to the system!). But- after using keyboard and mouse, I have remote on iphone using the official app working.

However, now, my problem is I'd prefer to use headphone jack out rather than hdmi... so a new series of problems. I appear to only have left-channel output right now, no stereo. I set the output using amixer cset numid=3 1 which didn't appear to work for quite some time, but rebooting appears to have solved the problem... then within xbmc, I noticed that xbmc hits the hardware directly... so I had to set it within settings to use analag output rather than HDMI. No matter what setting I choose in XBMC, it appears analog is stuck on left only. :( I can't confirm if it's on left only in the command line- so I'm turning there next.

Any comments regarding audio setup with raspbian and xbmc, I'd love to hear about! Thank you!!

(web interface using chrome to the web device also works, as well as the official xbmc app)

Thank you. and a tiny problem (picture larger than screen)

First of all I would like to thank you. followed your instructions, installed, updated, rebooted and it works well with all the fonts ant etc. (before I updated and rebooted , there was problem in fonts - it displayed quadrants instead of letters and screen was flicking all the time) . The only issue I have is that a display a bit larger then the screen . I tried to adjust it in settings but unsuccessfully.

all ok.

did it through video settings in xbmc itself. works like a charm :) thanks again ( besides the exit part) .

Try adding the following line

Try adding the following line to /boot/config.txt and rebooting:


did it - the resault is the same

and from some reason now it get stuck on exit and I need to force reboot by unpluging the power

Only exit on the menu

Hi, I ENABLED=1 in /etc/default/xbmc and it runs fine. However when I want to powerdown or reboot the pi, the menu options are missing - it only shows me Exit, while the menu options are then if I log in as PI and run XBMC-Standalone I see the extra menu items fine. XBMC seems to be running as user PI when it runs automatically

White Light Lines ad Border of Movie's

I'am getting Light shining Lines at the Borders of the movies I watch. Anyone else had that Problem? How can I solve it?

Keyboard does not work for search

The keyboard seems to work everywhere except when a text entry box has popped up. Searching for a file by its name would be a good example of this. Everywhere else the keyboard is working as it should though.

Yes, I'm seeing this too

And I did check that pi was in the all the groups in the install instructions and changed the xbmc user to pi. It looks like there is still a keyboard permission issue.

This worked for me

Scroll down or search for /dev/input in this thread:


Airplay video IOS 8

Hi, thanks for your work Michael

Do you think you will be able to post a release including the fixes for Airplay video support with IOS 8 ?



Realised I was still on 2.12 and apt-get update doesn't seem to be working.

Removed xbmc and tried from scratch, but for some reason apt-get is convinced 2.12 is the latest? Any ideas?

$ sudo apt-get install xbmc Reading package lists... Done Building dependency tree Reading state information... Done The following extra packages will be installed: xbmc-bin The following NEW packages will be installed: xbmc xbmc-bin 0 upgraded, 2 newly installed, 0 to remove and 0 not upgraded. Need to get 30.5 MB of archives. After this operation, 63.7 MB of additional disk space will be used. Do you want to continue [Y/n]? Err http://archive.mene.za.net/raspbian/ wheezy/contrib xbmc-bin armhf 2:12.2-1 404 Not Found Err http://archive.mene.za.net/raspbian/ wheezy/contrib xbmc all 2:12.2-1 404 Not Found Failed to fetch http://archive.mene.za.net/raspbian/pool/contrib/x/xbmc/xbmc-bin_12.2-1_... 404 Not Found Failed to fetch http://archive.mene.za.net/raspbian/pool/contrib/x/xbmc/xbmc_12.2-1_all.deb 404 Not Found E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?

12.2, not 2.12 I mean.

12.2, not 2.12 I mean.

the installation has deleted some important packages

How can I control what packages the installation will remove?

I have a distro of Rasbian wiht Gambas3. And the command : sudo apt-get install xvmc Delets the following packages which I need: Gambas3 , fonts-dejavu-core and more

Dont you need to increase GPU

Dont you need to increase GPU mem? If so you should add a note.

Where can i find the source. Its working fine for me so far and i am wondering why i should use openelec anymore :D Thats just great man! A bit more documentation/source would be nice though :)

(and an email notification about new comments/answers)

I thought I had mentioned

I thought I had mentioned that, but seems that I hadn't; thanks. OpenELEC is probably a bit more polished and has additional functionality or improvements, this is pretty much plain XBMC.

LIRC support? Raspbian-settings?

Hi, firstly, thanks for your work Michael, its so good that we able to install xbmc this way.

My question is: Is it possible that in tha latest stable gotham version (im on: deb http://archive.mene.za.net/raspbian wheezy contrib) there is no raspbian-settings addon in PROGRAMS section?

Anyway....im not found it in frodo 12.3 either, so i made a dist-upgrade and now im on gotham, but there is no luck, still not found raspbian-settings.

There is no addon named this, so i unable to enable LIRC.

What am i doing wrong? I missed something..?

Thanks a lot! Viktor

This build doesn't have any

This build doesn't have any additional functionality, the addon you're referring to is probably provided as part of RaspBMC. It doesn't look like LIRC support has to be specifically enabled, so it should be available.


[...] http://michael.gorven.za.net/raspberrypi/xbmc Posted in: How-To ⋅ Tagged: KODI, [...]


Thanks a lot for your work! Installation and everything went fine.

I tried airplay however (Settings->Enable Airplay) but it is not detected by the two iDevices I have whereas an android device detects the wi-fi reader (surely a different protocol such as UPnP). Both iPad and iPhone are up to date (ios 7.1.2).

Anyone has the same issue? Is it necessary to install a deamon (avahi-daemon) to handle airplay?

Thanks in advance for any help.


With a fresh install of

With a fresh install of raspbian and xbmc, avahi-daemon is not installed. It is mandatory for airplay to be detected. With a quick :

sudo apt-get install avahi-daemon

the problem is fixed.


Gotham 13.2 beta 2 hdmi no signal

after play video for some time (i think 20 minutes?) hdmi signal would stop and tv displays "no signal"... i don't think i have enabled power save tho. even if power save was enabled, why would it activate power save mode when video is playing? thx

I had this problem too. I

I had this problem too. I think its firmware-related, downgrade to earlier kernel fixed this for me, now im on somewhat 3.10.** now

[HELP] Broken packages held - Errors

pi@raspberrypi ~ $ sudo apt-get install xbmc Reading package lists... Done Building dependency tree Reading state information... Done Some packages could not be installed. This may mean that you have requested an impossible situation or if you are using the unstable distribution that some required packages have not yet been created or been moved out of Incoming. The following information may help to resolve the situation:

The following packages have unmet dependencies: xbmc : Depends: xbmc-bin (>= 2:11.0~git20120510.82388d5-1) but it is not installable Depends: xbmc-bin (< 2:11.0~git20120510.82388d5-1.1~) but it is not installable Recommends: python-qt3 but it is not going to be installed E: Unable to correct problems, you have held broken packages.

followed instructions and the

followed instructions and the same thing happened to me

[HELP] Broken packages held - Errors

You may forget to add to source list or apt-get update

  1. Add this line into /etc/apt/sources.list deb http://archive.mene.za.net/raspbian wheezy contrib
  2. sudo apt-get update
  3. sudo apt-get xbmc

Won't play MP4 video, mouse issues

I installed on Raspbian according to these directions.

If I run

xbmc file.mp4


xbmc-standalone file.mp4

the file does not play. In both cases, I see xbmc running fullscren. In fact, the application is slightly larger than fullscreen, and some of the text is clipped.

I used the mouse to navigate the application. Sometimes, the mouse becomes frozen, and other times, I see multiple mouse cursors. If I click on "Files", I get a dialog, but I can't choose anything from it.

h264 encoded video files not playing

i have the exact same issue. unable to play h264 (mpeg4 part 10) encoded video files. (but they do play in omxplayer)

mpeg4 part2 encoded files are playing ok though.