Volumio Simple Control Buttons

Overview

This project is for controlling Volumio by simple control buttons on ESP32 module.

This project offers to control:

Toggle (Play/Pause)
Volume Up/Down
Random Album Play (based on Randomizer plugin)

Supported Board

NodeMCU ESP32 (ESP32-DevkitC)

Pin Assignment

ESP32 Pin	GPIO Function	Assignment
GPIO2	OUTPUT	Blue LED
GPIO17	INPUT/PULLUP	Center Button
GPIO18	INPUT/PULLUP	Down Button
GPIO19	INPUT/PULLUP	Up Button

Quick Start

Installing Libraries to Arduino

WiFiManager

Arduino -> 'Tools' -> 'Manage Libraries...' -> Install 'WiFiManager' Version 2.0.3-alpha or later

ArduinoJson

Arduino -> 'Tools' -> 'Manage Libraries...' -> Install 'ArduinoJson' Version 6.18.3 or later

arduinoWebSockets

Download arduinoWebSockets-2.3.4.zip
Arduino -> 'Sketch' -> 'Include Library' -> Add .ZIP Library -> Select 'arduinoWebSockets-2.3.4.zip' downloaded above.
Note that arduinoWebSockets-2.3.5 causes build error.

Configuration for your enviroment

If Volumio hostname is other than 'volumio', revise following line in VolumioSimpleControlButtons.ino.

const char *VolumioHost = "volumio"; // Change here

Build

Arduino -> 'Tools' -> 'Board' -> 'ESP32 Arduino' -> 'ESP32 Dev Module'
Arduino -> 'Sketch' -> 'Upload'

SSID Setup (by WiFiManager)

Connect SSID 'OnDemandAP' when ESP32 power on at first time to set up WiFi connection.
See detail at WiFiManger.
Reset SSID configuration when ESP32 Reset button released with pushing Center button, Up button and Down button.

Button Control Guide

Center button single click to toggle (play/pause)
Center button 3 times click to random album play
Up button single/continuous click to increase volume
Down button single/continuous click to decrease volume

elehobica/VolumioSimpleControlButtons