Volumio2 Web Based User Interface
JavaScript HTML CSS Shell
Clone or download
Latest commit 88a6a0c Jul 24, 2018


Join the chat at https://gitter.im/volumio/Volumio2-UI Build Status devDependency Status bitHound Score

Volumio Web Interface

This UI is meant to be used as a standalone Web User Interface communicating via Volumio2 Backend via Socket.io API, see Volumio2 WebSocket API reference

Currently the UI is served via Express Static Server, and resides at /volumio/http/www

Repo information

This repo is used as a git submodule in Volumio2.
Only the dist/ directory is needed by Volumio2, so there is a dist branch which contains just that.

To update the dist branch with the latest changes, run:

git subtree split --prefix dist -b dist
git push origin dist:dist

Set up development environment

You must have Node.js, Npm and Bower installed

First clone it

git clone https://github.com/volumio/Volumio2-UI.git

Then, install its depencencies

cd Volumio2-UI
npm install
bower install

Now, you can develop on it, while retrieving data from Volumio2 backend (you must have a Volumio2 device on your network and know its IP address). To tell the UI where to find Volumio 2 backend, create a file with the IP of Volumio2 in


The file will look like

  "localhost": ""

Now, feel free to edit and see live changes on a local browser with dynamically generated UI. To do so:

npm run gulp serve --theme="volumio"

Once finished, to deploy on Volumio 2, first build it. if you want production optimization use --env="production"

npm run gulp build --theme="volumio" --env="production"

And deploy by copying the content of dist directory on Volumio2 device to: