Skip to content


JustBoom Xbian OS Configuration

JustBoom Xbian OS Configuration

This is a quick guide to show you how you can use the JustBoom boards with the latest version of Xbian OS.

Step 1 – Download and flash to an SD card the latest version of Xbian OS for the Raspberry Pi –

Step 2 – Insert the micro SD card into your Raspberry Pi and then also add your JustBoom HAT to your Raspberry Pi, making sure that the HAT is pushed firmly down on the GPIO pins. Connect all other peripherals, such as HDMI cable and USB keyboard & mouse and then power the Raspberry Pi.

Step 3 – once booted into Kodi, click on the power symbol and select exit to quite Kodi.

Step 4 – Login into Xbian with the default login credentials:

User: xbian

Password: raspberry

Exit from the popup window by navigating to “Exit” and hit enter.

Step 5 – From the command line edit the /boot/config.txt file with the following command:

sudo nano /boot/config.txt

Scroll down to dtparam=audio=on and comment out the line with the ‘#’ symbol at the beginning:


This will disable the on-board analogue audio.

Scroll down to the very bottom and add the following for the JustBoom overlay:




Finally save the file with CTRL+O & ENTER then exit with CTRL+X.

Step 6 – Now we need to remove a module that causes issues by editing the /etc/modprobe.d/xbian.conf file:

sudo nano /etc/modprobe.d/xbian.conf

Scroll down to the bottom and add the following:

blacklist lirc_atiusb

save the file with CTRL+O & ENTER then exit with CTRL+X.

reboot with:

sudo reboot

Step 7 – Once booted into Kodi, navigate to Settings > System > Audio  and under “Audio output device” select the JustBoom card (the default option of there are two).

Previous article How to configure your JustBoom IR remote for LibreElec
Next article JustBoom – Affordable, High Quality Audio for Everyone