Raspberry PI Display and Volumio: a touchscreen music player

101 Flares Twitter 0 Facebook 0 Google+ 0 Reddit 1 Pin It Share 100 StumbleUpon 0 Email -- 101 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 the official Raspberry PI Shop, or on Amazon). 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!

101 Flares Twitter 0 Facebook 0 Google+ 0 Reddit 1 Pin It Share 100 StumbleUpon 0 Email -- 101 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

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

    • volumio

      We’ll add some options for configuring different display sizes

      • Reinder Reinders

        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

        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

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

      • thisisnotsparta

        waiting for that too. Is it planned?

  • Justin

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

  • helloiamgary


    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

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

      • helloiamgary

        Cheers Olli, I’ll give that a go

  • Holger

    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

      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

        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

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

          • Walter van Eijk

            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

            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

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

          • Walter van Eijk

            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


      • Holger

        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

    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

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

  • stereofromlate90ies

    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

    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

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

  • pancakeroll

    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

    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

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

  • asmotiondesign

    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

    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

      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

    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

      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

        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

          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

            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

    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

      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

        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

    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)

    My System shows only the cursor after installing the plugin

    • Doc Schneider

      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

        Same here, using odroid display on rpi1.

  • nick singh

    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

      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


    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

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

  • Daniel Gaczol

    Will Raspberry Pi 3b be supported?

    • It is already supported

      • Gerard Bendotti

        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

    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

    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

    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

    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

      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

        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

          How did you get on?

          • Florian Trück

            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

        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

    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

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

  • Xander

    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

      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

    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

      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?

  • Sean Wu

    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?

  • Γεώργιος Προκόπας

    plugins page not loading

  • Sven Hartmann

    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

    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

    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


Related Posts