Ce document est également disponible en Français


Since Volumio 3 is out, it is not as easy as it used to be to install this operating system on a RaspTouch. Here is a walkthrough to find back all the device's functions under a recent version of Volumio (last update 27/02/2023)


Prerequisite

What this tutorial expects :

  • Your RaspTouch is connected to your (wired) local network with a RJ45 cable.
  • You have a PC (or any other device) on the same network and with a SSH client installed.
  • The clean procedure recommended by Volumio now requires a MyVolumio account.

Steps

A complete install needs 4 steps.

  • Set the audio output on Audiophonics I-Sabre ES9028Q2M
  • Install the plugin Audiophonics ON/OFF
  • Install the plugin Touch Display
  • Install a virtual keyboard

Set the audio output

v3.webm
  • Open Volumio Web Interface
  • Open the section Playback Options
  • Set the I2S DAC selector on ON
  • Under the drop-down menu DAC Model select the option Audiophonics I-Sabre ES9028Q2M
  • Save and agree to reboot
  • Wait a couple minutes for the device to restart.

Installing plugins

Since Volumio 3, you need a MyVolumio account to use plugins. A free account is enough for our needs.

Before continuing, open the link shown above and follow the instructions to create your account.


Installing the plugin Touch Display

install_plug_touch.webm

This video is edited because the installation lasts around 15 minutes.

  • Open the Volumio web interface.
  • Open the section Plugins.
  • Open the tab System Hardware.
  • Install the plugin Touch Display.
  • Wait for about 15 minutes without touching anything on the RaspTouch.
  • Once the installation is over, enable the plugin. The display should turn on after a couple seconds to show the web interface.

Installing the plugin Audiophonics ON/OFF

install_plug_onoff.webm
  • Open the Volumio web interface.
  • Open the section Plugins.
  • Open the tab System Hardware.
  • Install the plugin Audiophonics ON/OFF.
  • Wait for around 20 seconds without touching anything on the RaspTouch.
  • Once the installation is over, enable the plugin.
  • Verify at next power-up cycle that the physical power button stops flashing one the system has booted.

Verifying plugin installation

At this stage, this is what the installed plugins page should look like.


Installing a virtual keyboard

Everything seems to work now, but try using the search bar and you may notice that you need to plug in a keyboard to search for your tracks in the Volumio web interface.

There used to be a virtual keyboard plugin in Volumio 2 which made it possible to display a keyboard directly on the touch screen. Unfortunately, this one is no longer compatible with Volumio 3.

However we can reproduce this behavior quite easily with a few SSH commands.

Here's what we're going to do explained in the vernacular :

  • The Touch Display plugin is a simple chromium-based web-browser which is installed an set by the plugin to run automatically when Volumio starts.
  • We basically download a virtual keyboard chromium extension. I picked the one made by xontab because it is free and easy-to-use.
  • Then we only have to to edit the script in charge of starting the chromium-browser so it will also load the virtual keyboard extension.

Here how it translates in code :

cd /home/volumio/
wget https://github.com/xontab/chrome-virtual-keyboard/archive/master.tar.gz
tar -xvzf master.tar.gz
rm -f master.tar.gz
sudo sed -i 's/http:\/\/localhost:3000.*\?$/http:\/\/localhost:3000 --load-extension=\/home\/volumio\/chrome-virtual-keyboard-master/'  /opt/volumiokiosk.sh
systemctl restart volumio-kiosk
   	

The fifth command uses sudo because the regular Volumio user does not have the permissions to edit the file /opt/volumiokiosk.sh. This command will ask for the Volumio system password (by default : "volumio").

The last command restarts the chromium process. Usually the virtual keyboard is already working at this stage. However different system versions may need a reboot.

To make sure the virtual keyboard is working properly, use the touch screen on your RaspTouch and try to do a search.

Click on the navigation button.

Click on the text field.

Check that the virtual keyboard is displaying.



Last resort solution if you cannot get the above procedure to work.

As a last resort you may try this experimental installation procedure