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 XBMC and some dependencies which it requires. This can be setup on an existing Raspbian installation (including the foundation image).

Installing

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

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 XBMC), 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:

gpu_mem=128

You will need to reboot if you changed this value.

Running

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 ENABLED to 1:

ENABLED=1

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.

Release history

  • 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).

Flashing

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

Customising

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.

Updating

Both Raspbian and XBMC 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 Helix 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

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

http://michael.gorven.za.net/trackback/1498

Pingback

[...] Try this guide: http://michael.gorven.za.net/raspberrypi/xbmc [...]

Updated Jessie builds?

Is there a chance that new Jessie builds will be published? Currently, the latest ones are from November (beta 1).

Thanks a lot, finally a working solution

Hi Michael,

Wow ! I've been roaming the net for a few hours only to find dead repos and useless informations.

Thanks a lot for your hard work ! I'll finally be able to watch my favorite shows without resorting on cables from my laptop.

Can't wait to try my new setup when I return from work !

ThankYouThankYouThankYouThankYouThankYouThankYou

Thank you so much for your hard work, this is the only working solution i have found to install XBMC via rasbian. Its freakish how well this is runing on my A+

Keep the updates coming,

Matt

Missing RSS

I wanted to test the RSS crawl, the thing that scrolls some info on the bottom of the main screen, but apparently the RSS option is missing in settings. As I never used the RSS, mainly because of performance reasons, I'm not sure if the option got missing with the recent version or if that's just missing only on my installation. Does the RSS works properly for others?

FYI: apt-get install warning (Raspbian 2014-09-09 install)

Not sure if will result in any issues down the line but FYI:

http://archive.mene.za.net/raspbian/ wheezy/contrib xbmc all 2:13.2-1 ... Setting up powermgmt-base (1.31) ... /run/udev or .udevdb or .udev presence implies active udev. Aborting MAKEDEV invocation. Setting up pm-utils (1.4.1-9) ... ...

KODI naming

Can you please change your packages just to reflect the KODI naming scheme ? For example, the pvr addons works fine but the naming are still xbmc-pvr-* and they should be kodi-pvr-*. The same for eventclients. Its just a "cosmetic" thing but it would be nice if all follows the KODI naming scheme till the final release.

Thanks for your work.

doesnt play videos

heya at first i wanna thank you for your work here, very nice.

ive installed raspbian to run a seafile cloud. everything is fine with it. then i installed the xbmc media center like you said here. the xbmc is running and i can download apps and such things. but when i want to play videos like in the youtube app, i get these errors.

i first had only the stable versions and this error occurs

http://abload.de/img/p_20141202_214417t0j6d.jpg

as ive got the unstable package i didnt get the error, but the video also doesnt play. http://abload.de/img/p_20141202_215647xckpq.jpg

so if anyone could tell me what im doing wrong or what i have to do, to fix this, i would be happy

this has fixed

this has fixed

thanks but my problem is different because the video does play it just is not visible for a few seconds until the video menu changes to the playing video , I have reverted to gotham again now as the iptv addons are not included in any from here

kodi 5

i have upgraded to kodi 5 and 2 problems 1st when playing video files the play back starts but the menu screen is still showing so only the sound from the files is heard then the menu screen clears after some time. 2nd there is still no pvr addons such as simple iptv client

upgrade to beta 4

Hi

First ... THX for the great work :D

but i have a little problem with updating kodi (beta) ... Apt get tell me i have the newest version .. but i have beta 1 ... i have try'd upate/upgrade but nothing happens. how i can update the version?

Try this...

It should work by doing this:

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

I hope this helps.

I meant:

sudo apt-get update

sudo apt-get dist-upgrade

(In 2 different command lines)

didnt work kodi

didnt work

kodi --version 14.0-BETA1 Git:d6947be Media Center Kodi Copyright (C) 2005-2013 Team Kodi - http://kodi.tv

Are you using the unstable

Are you using the unstable repository?

yepp... do i need a different

yepp... do i need a different update rout?

gpg

W: Ошибка GPG: http://mirrordirector.raspbian.org wheezy Release: Следующие подписи неверные: BADSIG 9165938D90FDDD2E Mike Thompson (Raspberry Pi Debian armhf ARMv6+VFP) mpthompson@gmail.com W: Ошибка GPG: http://archive.raspberrypi.org wheezy Release: Следующие подписи неверные: BADSIG 82B129927FA3303E Raspberry Pi Archive Signing Key E: Encountered a section with no Package: header E: Problem with MergeList /var/lib/apt/lists/mirrordirector.raspbian.org_raspbian_dists_wheezy_contrib_i18n_Translation-en E: Списки пакетов или файл состояния не могут быть открыты или прочитаны. root@malinka:~# apt-key adv --keyserver keyserver.ubuntu.com --recv-key 5243CDED Executing: gpg --ignore-time-conflict --no-options --no-default-keyring --secret-keyring /tmp/tmp.ExdByQiYuv --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: запрашиваю ключ 5243CDED с hkp сервера keyserver.ubuntu.com gpg: ключ 5243CDED: "Michael Gorven (Package Signing Key) michael@gorven.za.net" не изменен gpg: Всего обработано: 1 gpg: неизмененных: 1 root@malinka:~# apt-get upgrade Чтение списков пакетов… Ошибка! E: Encountered a section with no Package: header E: Problem with MergeList /var/lib/apt/lists/mirrordirector.raspbian.org_raspbian_dists_wheezy_contrib_i18n_Translation-en E: Списки пакетов или файл состояния не могут быть открыты или прочитаны. root@malinka:~#

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)

######## END SYSTEM INFO
######### 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:

http://pastebin.com/T1U34p6B

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.

Kodi-pvr-addons

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

Hi,

Will it work in a Banana Pi with Raspbian installed?

Thanks.

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

Hi!!

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:

disable_overscan=1

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:

http://www.raspberrypi.org/forums/viewtopic.php?p=184477