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:



Did you add Michael's repository? sudo nano /etc/apt/sources.list.d/mene.list

enter the following and save it: deb http://archive.mene.za.net/raspbian wheezy contrib

Add Michael's key: sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-key 5243CDED

Then install: sudo apt-get install kodi

Same. Sudo apt-cache search


Sudo apt-cache search kodi Returns nothing


Live TV!!!!!

Finally have Raspbian boots to desktop with Kodi as an application and Live TV with ability to record! Tomorrow I'll get EPG sorted out. Thank you Michael!

Exit black screen bug solved on latest sources

It's been solved on this commit: https://github.com/xbmc/xbmc/commit/0e4577a2d704e72653f441080499d8925c5b...

Can you compile a new version with this fix, please? I would, but I don't know how to do it.

in with directory can i find the files on my pi ?

i mean the complete path ! i can't find them on my pi. or do i need to build and install kodi from source ? and how can i do that !

It would be great

It would be great if you can apply this fix in a 14.2 build since it seems to enter only on Kodi 15 Isengard.

KODI Black Screen Exit Fix

My working script. I start KODI from this script:


kodi -fs && sleep 1 && sudo service lightdm restart


Hi Michael,

Thanks for this - it's super useful.

Any idea why PVR addons aren't available? I was hoping to integrate with my MythTV backend.



Hi Michael, Maybe you should add to the instructions how to install the pvr addons? As you can see, not everybody remembers to do a "apt-cache search kodi" to find out which packages are there for the pvr.

Dear anonymous, in your case I think you'll need to do "sudo apt-get install kodi-pvr-mythtv" from a command line on your raspberry.



[...] La façon le plus simple de faire est d’installer les packages mis à disposition de Michael Gorven. Pour cela, on crée le fichier /etc/apt/sources.list.d/kodi.list : deb [...]

keyboard , mouse doest work

hey, install it on my volumio system

kodi started but cant control it with keyboard or mouse

please help here : )

Black screen on exit & need to replug mouse and keyboard

Hi Michael!

I have 2 problems. (Raspbian) First: When i exiting Kodi, i found black screen only. I need to start X from ssh (startx), then break them (ctrl+c), then i come back the original X desktop. Secondly: When i use Kodi, and i leave it, i need to replug my keyboard and my mouse too. Only operate again after this.

I updated always everything. (sudo apt-get update && sudo apt-get dist-upgrade && sudo rpi-update)

What is the problem?

Sorry for my english.

Best Regards,


Kodi exit fix

Hi here is a fix for black screen on exit http://tiny.cc/5c39tx

Kodi exit fix

Hi here is a fix for black screen on exit http://tiny.cc/5c39tx

Everthing is OK but Library is not working

Hello michael,

Thanks for great work. I have installed kodi on raspberry pi 2 and latest raspbian.

Everything seems good including CEC. Performance is good etc.

But video library is not working. I gave 2 ntfs external hard disks connected and also I have added some 1channel movies and shows to the library. But nothing happens at the library.. Note: I can browse files in disks.

I have looked over log files. but there is no any error.

How can I track this issue? Any clue? I'm good at linux and python but my first experience with kodi.

some parts from log.

... 20:12:03 T:1961799680 NOTICE: UpdateLibraries: Starting video library startup scan ... ... 20:12:04 T:1798304784 WARNING: CPythonInvoker(2): Script invoked without an addon. Adding all addon modules installed to python path as fallback. This behaviour will be removed in future version. 20:12:04 T:1836053520 NOTICE: VideoInfoScanner: Starting scan .. 20:12:04 T:1836053520 NOTICE: VideoInfoScanner: Finished scan. Scanning for video info took 00:00 ...

Ther is no "Add Videos..." button


Beside my previous issue, I have just realized that the "add videos..." button in Videos also is missing. Bu in music page there is a add musics button.

workes fine until shutdown or hard reset

I installed XMBC on a raspberry pi 2 running wheezy several times now. It worked good until I shut down XBMC. This is destroying the file system on the SD card - and I have to install again. Interrupting the power supply leads to the same result. I do not know what the reason is, but it seems to be related to XBMC. Shutting down or interrupting the power supply with only raspbian running workes well. With XMBC file system crashes repeatable. By the way: If only openelec is installed the system shows the same error.

I prefer the solution based on raspbian to have a real OS- not just a media player.

Any ideas?

best regards Thomas


All, I have to correct my statement from above. The behavior is diffrent between shutting down and interrupting power supply. Shut down seems to to be related to the "black screen" topic. Switching of power supply destroys the file system. I haven't fixed it yet. Maybe I have a typo somewhere in the scripts described in the linked fix. But it seems to be the right track.

Michael can you fix the long standing errror

Kodi does not exit. I and everybody are getting "Exception SystemExit in ignored Exception SystemExit in ignored"

CEC & Sound Problems

Hi and thanks for a great resource here! I'm having problems getting CEC working with my Samsung UA55H7000 TV. Despite the TV telling me it is connected to Kodi with CEC, there is no response from any buttons. Is anyone else experiencing this? Also, I've noticed some glitches & stuttering with the sound at times with some files.

Could these issues stem from this particular build or are they more likely to be kodi general issues?

Thanks in advance for any help/advice you can provide!

my too

I have the same problem here, whith my Samsung ua40h7000

kodi, Raspbian and vnc

Hi, first of all: thanks a lot. I installed on kodi on a brand new RPi2 without any problems (following your suggestions) and it run like charm.

I also installed tightvnc on my Raspi, but I cannot access kodi with a vncviewer from my iPad (and not from Windows with vncviewer as well.

I started kodi with kodi-standalone. Do I need to do something different ?

Usually, I run my Raspis headless as soon as I have them set up.

Thank you for your work !

Cheers Joshi

Raspbian + kodi + rpi2

just do a fresh install of raspbian and your kodi on the rpi2. I think there ist no hardwareacceleration for HD movies. I could not see the video. SD files working great. If i turn of hardwareacceleration than i see the video but it is very very slow.

I think this is based on the new armv7 chipset.

Does anyone makes kodi run with hardwareacceleration on the rpi2?

btw. openelec runs very fine but is useless for me cause i need a desktop environment too.

btw2. thx for yout work and kodi build ;-)

epic fail

Just my fault... Forgot GPU_mem. I use 256 mb. Every thing fine now.

Lag with 14.0

Anyone else noticed lag on 14.0 when playing bigger files? (or is it the new 3.18.5+ kernel?)

Compatible to Raspberry Pi 2?


is Kodi compatible to the new Raspberry Pi 2? Does it run on multiple cores?

Not optimized for ARMv7

Because there is only one compiled version of kodi for Raspberry Pi 1 and 2, it means that it is not compiled using ARMV7 processor optimizations. Could you please make an optimized version for ARMV7 ?

Unfortunately I don't really

Unfortunately I don't really have the time to work on a major change like this, and I don't have a Pi 2 to test it on. My packaging is available in this bzr repo if you want to try this yourself.

Yes and yes

Yes and yes.

Kodi on PI2

Have the actual version 14.0 running on a new PI2 with USB-Disc and MySql-Server (2nd PI, but old one). One can even use huge skins like AeonNox without delay or any limitations. Runs smooth like on my notebook with Core3 (1.6Gh), great piece of hardware for its price. CPU usage always very low, no problems at all.

Great job!


Hi, Did you use raspbian or


Did you use raspbian or debian jessie?

Update to KODI 14.1

Hi Michael

Can you please build 14.1 and put it in the unstable repo at least ?

Thanks for your work.

14.1 is now available, as

14.1 is now available, as well as updated SD card images.

On this occasion....

On this occasion I want to say Thank You very much for all your work, Michael! You really made the last few years for a Windows guy with a RPi who doesn't know very much about Linux or Kodi very easy and comfortable. And I guess not just for me but for another thousands of people out there. Thanx very much for all your help, for your time and effort! I don't take all this for granted and know there's a lot of work behind it. mattx

Thanks! :-)

Thanks! :-)

thanks a lot ! :)

thanks a lot ! :)

No Sound

I have the Problem that i can´t hear anything. The pi is connected to a AV- Reciever. HDMI or Analog nothing works. I have got a Raspian Image installed.

Can you help me?

Error When plays an mp4

Hello Michael, I've keep your howto and when I try to play a mp4 file I get this error: ERROR: ExtractThumb - Error creating demuxer ERROR: OpenDemuxStream - Error creating demuxer ERROR: Playlist Player: skipping unplayable item: 0, path [/home/pi/los.100.mp4] ERROR: ExtractThumb - Error creating demuxer Do you know why ?

Kodi 14.1 is out and so the new Raspberry Pi 2

Kodi 14.1 is out and so the new Raspberry Pi 2

p2p repo

I have been trying to get the p2p addon working it has installed but it cannot find the os the choices are openelec,(no) xbian (no) raspbmc(no) pimple?(no) arch linux none of them work it loads the modules and then connects but then I get error the rar is not available or corrupt has anyone got p2p working on this installation the repo is xfinity.xunitytalk.com

p2p repo

I have been trying to get the p2p addon working it has installed but it cannot find the os the choices are openelec,(no) xbian (no) raspbmc(no) pimple?(no) arch linux none of them work it loads the modules and then connects but then I get error the rar is not available or corrupt has anyone got p2p working on this installation the repo is xfinity.xunitytalk.com

It works

Sorry last comment (I am the same anonymous person). I use YOUR step by step tutorial... and now it works. I still not attempt to watch a movie or install add-ons or anything, but it runs. After many days of disappointments, I am happy. Thank you.

Doesn´t work

Hello, I had follow, rather, copy, paste and execute this script:

http:// tech.enekochan.com/es/ 2014/02/19/ script-de-instalacion-para-xbmc-en-raspbian/ #comment-57725

that is based in this page (delete blanks on URL).

But I have many mistakes (after clean many scaping character problems) I found that the comand xmbc is not reconigzed, or that /etc/default/xbmc doesn´t exist.

I have the last version of Raspbian.

Thank you very much.

Vuplus addon

Hi, Has anybody got this addon working? Seem to have a problem in that every time I select a channel it doesn't stream, just goes back into Lodi main menu

Kodi doesn't exit

Exception SystemExit in ignored Exception SystemExit in ignored

Kodi doesn't exit

i have the same problem, leave KODI, processes kodi and kodi.bin continue to run. Only a kill terminate it.

I have exactly the same

I have exactly the same problem on an old install in a old raspberry pi and in a freshly installed system in a new raspi 2.

the same here...

the same here...

please Help

I've tried to instal but i have an error since my first command! When i put deb http://archive.mene... etc i have a line that says: bash: deb: command not found

Please if you know where i am wrong please advice me how can i do to fix it.. thank you

Hi. This is not a command.

Hi. This is not a command. You have to edit the file /etc/apt/sources.list.d/mene.list with a text editor:

$ cd /etc/apt/sources.list.d/ $ sudo nano mene.list copy the row deb http://archive.mene.za.net/raspbian wheezy contrib ctrl + x to save.

then procede with the other step.

bye (sorry for my english :| )