Here the full README of the project:
Play on Volumio
A Chrome extension that adds “Play on Volumio” buttons to albumoftheyear.org, so you can browse albums and play them directly on your local Volumio player.
Features
- Play on Volumio – One-click album playback from album pages
- Now playing overlay – Floating player on albumoftheyear.org (artist, album, track, seek bar)
- Media Session – Control playback from macOS Control Center, media keys, keyboard shortcuts
- Album art – Shown in OS media controls when available
- Works on Volumio tab – Media Session also controls when the Volumio Web UI tab is open
Requirements
- Chrome (or Chromium-based browser)
- Volumio running on your local network
- albumoftheyear.org – Extension only works on this site
Installation
- Clone or download this repository:
git clone https://github.com/matze-media/play_on_volumio.git
- Open Chrome and go to
chrome://extensions/ - Enable Developer mode (top right)
- Click Load unpacked
- Select the folder containing the extension
Configuration
- Right-click the extension icon → Options
- Set your Volumio settings:
| Setting | Description |
|---|---|
| Volumio server IP | Your Volumio device IP (e.g. 192.168.1.100) |
| Volumio API port | REST API and WebSocket port (default: 3000) |
| Volumio Web UI port | Optional. Port from the browser when Volumio is open. Use 80 for http://192.168.1.100, or 8080 for http://192.168.1.100:8080. Leave empty to use the API port. |
Usage
- Album pages – Click
Play on Volumio to play the album - Discover / artist / ratings pages – Play buttons on album cards
- Now playing – Use the floating overlay or OS media controls (play, pause, next, previous, seek)
Supported Pages
- Album detail pages (
/album/*) - Artist pages (
/artist/*) - Discover, search, genres, releases
- Ratings and lists
License
MIT