Raspberry PI Display and Volumio: a touchscreen music player

102 Flares Twitter 0 Facebook 0 Google+ 0 Reddit 1 Pin It Share 101 StumbleUpon 0 Email -- 102 Flares ×

Finally, the touchscreen plugin is available!

One of the most awaited plugins for Volumio is finall here: the touchscreen plugin. With it you can easily show the gorgeous Volumio UI on any display, included the official Raspberry PI Display, available on our Shop. Let’s see how to easily achieve a fantastic touchscreen for your favourite music player in less than 10 minutes. This tutorial will explain how to connect the Raspberry PI display and enable the Volumio UI with the plugin.


STEP 1: The wiring 

Assuming you’ve already downloaded and flashed Volumio to your Raspberry PI (we suggest to use the newest  Raspberry PI 3), the first step is the wiring:

  1. First, let’s attach the ribbon cable going from the Raspberry PI Display to the PI itself. On the Raspberry PI Side, make sure the blue part of the ribbon cable is facing outwards. Your final goal should look like this:
  2. You’ll have 4 coloured cables to connect too. They are 5v, GND, SDA and SCL. You can look at the below image to identify the proper pin on the Pi itself.
    volumio-raspberry-pi-display-touchscreen-4Therefore, the wiring should look like thisvolumio-raspberry-pi-display-touchscreen-3
    Done! You’ve done the wiring required to connect the Raspberry PI official touchscren, let’s move on!

STEP 2: Power Supply Check 

Notoriously, feeding your PI with an adequate Power Supply is mandatory to have a reliable system. That’s especially true when we connect a power-hungry device like the Raspberry PI Display. Luckily, there’s a way to understand if your PSU is good enough: just power on your pi and observe the screen, if you see a coloured square on the top-right side of the screen, it means that power to your PI is not enough. Don’t you see it? Then all is good.



If you have such problems, don’t worry. Good power supply are cheap and easy to find. Here’s the NorthPada 5V 2000mA PSU, my personal favourite.


STEP 3: Install Volumio’s Touchscreen plugin 

That’s the easy one. Just connect to Volumio’s WebUi as you would usually do, and navigate to the Plugins page from the settings menu. In Miscellanea category, you’ll find the Touchscreen plugin. Just click install, nothing more. PLEASE NOTE: The touchscreen plugin is compatible with volumio version from 2.001 onwards


The installation will last about 7 minutes, so wait patiently until you see “Installation Complete”. Now you can enable or disable the Display output to your likings.


STEP 4: Enjoy it!!!

I must admit that altough this display is not particularly brilliant when it comes to resolution and colour accuracy, it looks indeed very nice with Volumio’s UI. Also, usability is very good on the Raspberry PI 3 and the UI runs smoothly also with big libraries… So, folks, enjoy!


Are you looking for alternatives? 

If you don’t have a Raspberry PI, or you’re simply looking for alternatives to the Official Raspberry PI Display, there are at least two extra options for you:



The Odroid display is not only a viable alternative, it also have several advantages over its PI counterpart:

  • Since it takes power from USB and video signal from HDMI, it can be used virtually with any Computer with an HDMI output, not just the Odroid or the Raspberry PI.
  • It has a better resolution: 1024 x 600 vs 800×480 of the PI display
  • It’s somehow simpler to integrate into a beautiful case (thanks to its mounting holes)
  • You can still use an I2S DAC with the Display, since it does not use any GPIO port (both on Raspberry PI and Odroid)

The Odroid Touchscreen display is available at Odroid’s webshop or on Amazon



The Waveshare 7” display has become rapidly a widely adopted display, thanks to its cheap price. However this particular touchscreen has shown several reliability issues (altough this seems fixed in latest models, thanks to a firmware update), it requires a particular touchscreen driver which is not always included in major distros and its colour reproduction is not the best.

It can be found at the Waveshare Shop or on Amazon


Here we are folks! Hope you found this article helpful, you can share via comment below how you use your Volumio’s touchscreen setup and if there are other display alternatives!


Get your Official Raspberry PI Display from our store and help the project!

102 Flares Twitter 0 Facebook 0 Google+ 0 Reddit 1 Pin It Share 101 StumbleUpon 0 Email -- 102 Flares ×
Liked it? Take a second to support Volumio on Patreon!

Michelangelo Guarise

Passionate. Heretical. Deeply in love with Technology and Music. I live in Florence, Italy where I teach Interaction Design and Marketing. I'm Volumio's founder and CEO, and I love every second of this great adventure. My audio gear is some strange mix of valve and digital amplifiers, all self built in some cold winter sleepless nights. And I just can't turn that volume knob down.


Tobias Bruns - October 18, 2016 Reply

Great News! Does this also work with smaller Touchscreens (2,5″, 3,5″…) ?

volumio - October 20, 2016 Reply

We’ll add some options for configuring different display sizes

Reinder Reinders - November 17, 2016 Reply

Cool I am also waiting for this, I tried volumio about a year ago, but it didn’t fit good on my PiTFT Plus 480×320 3.5″ TFT

mrsmrs78 - November 25, 2016 Reply

Is there a time line for that?

I have a 7″ Display (Pollin LS-7T). It works widely with the plugin except of the calibration of the touchpanel.
Is it possible (for a boob) to change the touch calibration manually?
Thanks for all your work!

Pka - December 12, 2016 Reply

Also looking for answer this one. X11 won’t start if i touch & edit 99-calibration.conf file.

thisisnotsparta - February 8, 2017 Reply

waiting for that too. Is it planned?

Justin - October 18, 2016 Reply

I would like to see Tontec 3.5″ support – it would be like having a wall thermostat for music.

helloiamgary - October 20, 2016 Reply


Thanks for this. Is there any plans to include a screensaver or a time out for the screen to dim? I’ve been using the waveshare 7″ for a few days since upgrading and am starting to see some screen burn on it from the white buttons on the now playing screen.


olli - November 13, 2016 Reply

you can install xscreensaver and configure it to blank, see above

helloiamgary - November 13, 2016 Reply

Cheers Olli, I’ll give that a go

Holger - October 21, 2016 Reply

Hello Michelangelo, I was so happy when reading this! I immediately bought the official Display, but then I looked closer at the used GPIO2-3; these are used by the Hifiberry Amp+ as well. So, is there any way to combine the Pi3, the Amp+ AND the display? I have posted a request for help in the related help topic in the volumio forum, 2days ago, addressed at you. Maybe you – or someone else – can help me. Thank you in advance, all the best, Holger aka hannibal….

Tom Van Wehaege - November 8, 2016 Reply

Hello Holger, i have the exact same order comming in. rPI3, hifiberry amp+ and 7” screen.
Did you find out how to connect the parts and make it work?

Walter van Eijk - November 14, 2016 Reply

You should be able to connect them as follows:
– 7 Inch screen
– Raspberri Pi
– HifiBerry AMP+

At least, that’s how I did it. This picture is taken with a 2B Pi, but it works exactly the same with a Pi3 (already tested). I am installing Volumio2 on it as I am typing this.

Tom Van Wehaege - November 14, 2016 Reply

Do you power the screen and the pi? 3 chargers? What about the gpio’s?

Walter van Eijk - November 15, 2016

I am using a 12V adapter and/or battery, that is connected to the Hifiberry AMP+. From there, it powers both the Pi as the screen.
Also, by using a accusafe (www.accusafe.com), I can switch between the battery and the adapter.
So, when I’m at home, it simply runs on the adapter, when I’m not at home, it runs on the battery (for at least 6 hours). I got Volumio2 running flawlessly yesterday evening, now only to see if the volume is as loud as it was before.

scot-e-dog - December 28, 2016

I have this set up. I have the official RPi3 power supply connected to the screen and then a very short USB cable from the screen’s USB-A port to the USB-B power in for the RPi. With a HiFiBerry DAC+ as well, this is pushing the capability of the power supply, so you will need quality cables, etc.

julienlarivee - February 12, 2017

Hi Walter,
What is the A output of your battery?

Walter van Eijk - February 13, 2017

Not really sure, and I can’t check it, because the crate the battery is in is glued shut….
However, I’m using this battery, it’s a 12 V 7.2 Ah battery:


julienlarivee - February 13, 2017


Holger - November 15, 2016 Reply

Hello Tom,
sorry for the late response, I’m currently re-organizing my media for volumio 😉
As Walter already said, it works – even without the I2Cs being connected.
I use 2 separate power inputs: one for the DAC and the Pi3 and one for the Display.
After flashing Volumio 2 you’ll have to install the display plugin, get the lcd rotated and that’s it.
still haven’t got response by Michaelangelo or the Volumio team if/for
what the I2C connection is really needed; that’s the only thing I want
to know.
all the best,

Sven Nyström - October 26, 2016 Reply

Hello, Works perfect except that in my view the display is upside down if one uses the standard case for the official touch screen. Could an option to rotate the display 180 degrees be added?

olli - November 13, 2016 Reply

add lcd_rotate=2 to file /boot/config.txt and reboot

stereofromlate90ies - October 28, 2016 Reply

That’s excellent! Could you just add something to the suggested display types?
I would like to keep the pi hidden in a wardrobe but having just the
display outside for the GUI. This would require a cable length > 1m. I
don’t think the ribbon cable of the Pi display would do it, right? Any
other suggestions for a good display with a longer connection cable? I’d
really like to have the system stable so I’m not keen on the Waveshare.
Thanks a lot!

Binh Ton - November 1, 2016 Reply

I got the touch screen worked correctly. However, I have tried to find a way to enable screen saver to put the screen into blank mode after sometimes. I could not find any way yet. Without screen saver option, I am afraid the screen would be burn.

olli - November 13, 2016 Reply

you can install xscreensaver, set it to “blank screen only” after X min with “quick power off in blank only mode”

pancakeroll - November 6, 2016 Reply

Successfully installed this plugin and setup with an HDMI monitor but receive no output but a flashing cursor under the volumio login ? I have the plugin set to active and have tried a reboot. What am I doing wrong ? Thanks…

Tom Van Wehaege - November 8, 2016 Reply

with a screen on the RPi, the sound from Volumio goes to the jack. isn’t that a step back for the sound? What with a DAC-board of even a AMP-board?

olli - November 13, 2016 Reply

no need for the jack, got it smoothly running with a hifiberry dac+

asmotiondesign - November 10, 2016 Reply

I’m getting just a blank screen with a cursor (touch works – you can move the cursor) but no UI.
Installed the touchscreen plugin, did everything as per guide – no dice.
Anyone have any ideas?
rPi 1 b+.

olli - November 13, 2016 Reply

love it 😉 is there a way to decrease the size of the web ui by some pixels so that this ugly scrollbar on the right hand side disappears in playback view on the official display?

Mike Willems - February 3, 2017 Reply

I have a similar issue. I have a Rpi3 with official touch screen w/ Raspbian installed. I have chromium browser set to launch on startup and launching my volumio.local screen. The browser window doesn’t fit exactly so the volume doesn’t slide nicely. You have to touch the volume repeatedly to turn up the volume. PLEASE HELP!

Vewehr - November 16, 2016 Reply

Does touchscreen of Odroid VU7 PLUS work out of the box (with the plugin installed) on Raspberry Pi 3? And what about VU5? I’d like to use 5″ screen for my DIY kitchen Internet radio. THX.

Petr Gratz - December 28, 2016 Reply

I have successfully installed Odroid VU5 (hdmi + usb cables), but you would need to modify display resolution to 800×600 – I added hdmi_group=2 and hdmi_mode=9 into /boot/config.txt. It works as a “display” only now – no control using touchscreen. does anybody know how to do it?

Ryd - January 24, 2017 Reply

Same problem here. Odroid forums hint at needing a driver compiled for the kernel? Display works fine, but touch does not work. I suppose I will order Odroid C1/C2 instead of using an old rPi I had..

Arnon Tsairi - March 14, 2017 Reply

Is the source of problem with Odroid screen Volumio or RPI? In other words, do you think Odroid C2 and Volumio work out of the box with the VU7 screen? thanks

Ryd - March 15, 2017

I suppose it’s about the driver for the screen, no-one has compiled the odroid display driver for rPi. I’m not 100% sure it would work on odroid either, safest bet is to go with official rPi display with rPi. It’s very misleading to state in this blogpost that odroid display is a viable alternative to the official rPi display, since it does not work at all (after messing with configs you can get it to boot to grey screen with cursor and touch does not work).

Massimo - November 18, 2016 Reply

Uhm, does the touchscreen UI need a *real* keyboard attached to make a search? It’s useless in that way… Any workaround?
And I would really like a better way to sort, as suggested by kaosmagix here https://volumio.org/forum/#p23265

Matika - January 6, 2017 Reply

I found a solution to this by installing matchbox-window-manager and matchbox-keyboard and editing a file:


– (ssh) login to the volumio box

[quote]apt-get install matchbox-window-manager matchbox-keyboard
nano /opt/volumiokiosk.sh

change the file to the following:

xset -dpms
xset s off
xset s noblank

matchbox-keyboard -d &
matchbox-window-manager -use_titlebar no &

# openbox-session &
while true; do
rm -rf ~/.{config,cache}/chromium/
/usr/bin/chromium-browser –disable-session-crashed-bubble –disable-infobars –kiosk –no-first-run ‘http://localhost:3000’

reboot. voilá – onscreen keyboard.

Ian Stone - January 24, 2017 Reply

Well that brings up the matchbox keyboard but it now boots to a web browser and no touchscreen volumio access… any idea why?

Could it be I used sudo nano to edit the kiosk file? just using nano meant that I wasn’t allowed to edit the file when I tried to save it?

torrie0712 - November 25, 2016 Reply

I have a question. I installed the plugin and it’s active. But the only thing I see on my touchscreen is a log in screen for volumio and not the volumio ui. Do I have to log in manually or how does the plugin work.


Kevin Majewski (fisch02) - December 28, 2016 Reply

My System shows only the cursor after installing the plugin

Doc Schneider - January 5, 2017 Reply

Me too. Any idea what went wrong? I use a Waveshare 5″ touchscreen, fresh install of Volumio 2 on a Raspberry Pi 2 and a Iqaudio Dac attached to it. Just installed the touchscreen plugin, activated it and rebooted.

Ryd - January 24, 2017 Reply

Same here, using odroid display on rpi1.

nick singh - January 13, 2017 Reply

I went out and bought the screen just so i could use volumino but I am stuck on the 70% when trying to install the plugin on my raspberry pi 3 . Now i can not even get to miscelleano section in the plugin area. Anybody know what might be going on?

Florian Trück - March 5, 2017 Reply

This will likely be the package keyboard-configuration if it wasn’t installed before. When this package gets configured dpkg asks for the language to be set. The package installer doesn’t take care of that. I’ve managed this issue rebooting volumio right when this issue happens, and calling “dpkg –configure -a” from bash either doing ssh or direct input from console. When this is finished do a second reboot and install the plugin again from volumio interface. this time it should run to end.

Jason Girard - January 15, 2017 Reply


I just got Volumio 2.041 working on my RPi 3. I am very interested in this plugin but have a couple questions before proceeding:

The normal login screen is a terminal. How will the Volumio GUI show up on a touch screen connected to the Pi? Do I need to install/launch a window manager, bring up a web browser, and use it as I have been using on a remote PC? Or does the Volumio GUI launch by itself once I log in from the terminal?

The touch screen will be a Waveshare 7″ which I also recently purchased. Please advise of any configuration items that need to be tweaked as I haven’t set it up yet.

Cristian - January 21, 2017 Reply

ciao ma e’ possibile collegare un waveshare 4 inch hdmi lcd?

Daniel Gaczol - January 26, 2017 Reply

Will Raspberry Pi 3b be supported?

Volumio - January 27, 2017 Reply

It is already supported

Gerard Bendotti - April 25, 2017 Reply

In the “Details” part for this plugin it says this “Using this plugin is not recommended with Raspberry PI B+! Suggested, Raspberry PI 3, Odroid C1 or C2”

Ken Ip - February 2, 2017 Reply

How could I know if this touch screen is supported by Volumio? It’s 5 inch, 800×480 pixels, HDMI, power by 5V 2A micro USB. The manufacturer said that they will provide a version of Raspbian with the driver for the touch screen but not any other OS.


julienlarivee - February 8, 2017 Reply

I am looking into making a wireless music box running on volumio.
It would have the Raspberry Pi 3, HifiBerry AMP+ and the 7 Inch touchscreen.
All this would be powered by a battery connected to the Pi by the Adafruit Powerboost 1000C. https://learn.adafruit.com/adafruit-powerboost-1000c-load-share-usb-charge-boost/overview

Does anyone know if the powerboost can deliver enough power for the Pi, the amp and the screen running all together?

Mickey9801 - February 17, 2017 Reply

Hi, can the touch screen UI support multi-lang? I found that the plugin works great but Japanese and Chinese become “???”. Is it possible to replace some font file and let the system support UTF-8 encode for work around? Thank you.

Craig Gauntlett - March 4, 2017 Reply

Kernel panic after plugin install

I have just built a fresh pi3 with the official touchscreen all works perfect until I install the touchscreen plugin and after a reboot I get a kernel panic. Any advice? Is this a known issue?

Florian Trück - March 5, 2017 Reply

Same problem here. Seems to be an issue with the new rpi-kernel which gets installed during the installation of the plugin. Not sure how I can fix this but I’ll do some research too. 🙂

Florian Trück - March 5, 2017 Reply

OK, I did some investigations.
I’ve downloaded the plugin to my PC to see the install script.
I’ve noticed some things:
– Chrome package does not install correctly as there are several dependencies not met
– apt-get -y -f install does not install all requirements
– I had to install libgnome-keyring-common and libgnome-keyring0 manually

The issue comes with installing of the chromium .deb from the download source. It installs a new bootloader and also a new kernel image. This seems to break RPI boot process.

I’ll reset my SD-Card Image now and try to install chromium from official apt-repos.

Quentin Smart - March 18, 2017 Reply

How did you get on?

Florian Trück - March 20, 2017

I’ve had discussion with the plugin developers. They updated the plugin. Now you only have to do “sudo apt-get install keyboard-configuration” via SSH BEFORE you install the plugin. Everything works now, but it is kind of sluggish as the RPI is a slow device.

Florian Trück - March 5, 2017 Reply

More investigations: Installing chrome from apt repos also breaks RPI3 boot.
I see two options so far:
– pinning kernel and bootloader so that they do not get updated (will try this)
– getting new bootloader and kernel to work with RPI3 (will try this afterwards)

Tunc Ugurdag - March 10, 2017 Reply

I need to know how to play my music from esata port on cubox-i as I was doing this before on old version…
pls help

Mario Pagliuca - March 22, 2017 Reply

Volumio don’t work with the raspberry offcial touchscreen monitor 7″.
Any solution?

Xander - March 29, 2017 Reply

Hi all,
I followed the turorial above, but got still a login screen on my touchscreen instead of gui. What do I wrong?

Brady Spitz - June 30, 2017 Reply

I’ve had this same problem… I reboot with Volumio flashed and it pops up as volumio login. I used volumio/volumio and it seemed to login, but now I’m left at the volumio@volumio:~$ prompt. Any luck figuring out how to navigate back to GUI?

Roderick - April 8, 2017 Reply

Plugin install is stuck at 70%, at 21. other, please help… I’ve downloaded the latest Volumio 2.129. But nothing i do works. Help!!!

Roderick - April 8, 2017 Reply

I got it working… I read on a different website that you had to unplug the keyboard and then reboot it in volumio.local. This I did and then reinstalled the plugin. Now it works.

Different question though; is there a possibilty to activate a screensaver, or dim the screen?

Eddie - January 25, 2018 Reply

I have the same problem, I’ve tried to do what you did but didn’t work!!!

Sean Wu - May 16, 2017 Reply

I fond that there are lots of touch screen available for RPi 3 in different size.
Which size and resolution supported by this plug-in?
Is there any compatibility list available?

Γεώργιος Προκόπας - May 18, 2017 Reply

plugins page not loading

Sven Hartmann - June 30, 2017 Reply

hi guys, i got an problem with an small 3.5 tft touch screen. i install volumio and it work perfekt. i can use it over the web page and the sound is awsome with my creativ Roar over usb cable, but my touchscreen is still clowing white. i install the touch plugin an select touchscreen and the activ dot is green but the display is not working. it is an xpt2046 pi tft display. what can id do???

GreenWarfare - September 8, 2017 Reply

I just set this up and it’s nice how everything works quite out of the box (note: I’m not a Linux afficionado).

However, what I dislike is that while using my PC browser or smartphone as “remote control” works well, everything get’s very laggy when using the touchscreen (slow scrolling, delayed playback, things like that). However, this might be homemade, as I’m still on a RPi B+. What’s your experience with newer RPis? Can I expect more speed?

Also, what annoys me is that the display goes black after a couple of minutes. Is there a way to prevent this? I’d like to have the album art and metadata visible at all times.

And, finally, after the first reboot the tabs on the screen don’t read “Playback”, “Browse”, etc anymore, but something more cryptic like :common.tab_playback and common.tab_browse. How can I revert this?

Ryan Ridley - November 22, 2017 Reply

I have the following screen

I have volumio all working but i just cant get the touchscreen working at all. I have tried to add some line to the config.txt but still nothing and i have also installed the touch display plugin but nothing.

Any help would be appreciated


Georg Matejka - April 2, 2018 Reply

Just couldn’t get the original raspberry pi display running together with an iqaudio-digi-amp. They both are hat-devices, so maybe there is some i2s-problem? Something in particular to consider? Or should I just try another amplifier like the seemingly magnificient allo-boss? I tried various combinations and wirings, having set all the wires no more music comes out! So any help is appreciated!

Georg Matejka - April 7, 2018 Reply

Got it running, thanks to Gordon from IqAudio. I did not connect the yellow and the green cable, red and black for power supply is enough.

Matula - April 5, 2018 Reply

Hi guys,

i’m just wondering, if a screen like the one below is working with PI/Volumio?


Best regards,

Matula - April 16, 2018 Reply

Hi Everybody,
i’d like to tell, that above mentioned screen works out of the box!
Display via HDMI and touch via USB, very nice handling.
Only drawback is: Volumio doesn’t use the full size of the screen for the display, there is a 1 1/2 cm wide black border around the whole display. On the other hand, volumio uses full size for touch input, so moving to the border leads to divergence between display and touch-input.
Question: is there a possibility to force volumio to use full size of the screen for the display?
Best regards,

Add your comment

Related Posts