Homebridge Volumio Speakers

Add your Volumio zones to Apple Homekit. This platform plugin uses the SmartSpeaker service to automatically create accessories from all your Volumio zones that show up as real speakers in Homekit.

Functionality

You must have iOS 13.4 or later.

All your zones will show up in Homekit (after you add them one by one, see instructions below).

Currently the SmartSpeaker service is extremely limited and it only has the following functionality:

Showing the current status of each output (Playing, paused, or stopped).
Pausing/playing each output (unless that output is stopped).
Volume setting via Homekit scene (See below for more)

However the SmartSpeaker service does show some promise. Although it is all based on Airplay 2, there is a chance (if somewhat slim) that we'll also be able to control volume and other transport controls later on.

How to set volume

Currently, most of the functionality you'd expect from a speaker accessory is handled through the Airplay 2 protocol, which as of th etime of writting, doesn't have an available, open source implementation. That means that when you long press on the Speaker tile in the Home app, you'll see a message stating...

Controls unavailable for this device

...and controls like pause/play, next/prev track, and the volume slider are greyed out. However, if you create a scene in homekit and include the accessory, you'll have a "Media" and "Audio" option down below the accessories list. In there, you can select a volume to send to the device as long as you're using one of the "Play Audio", "Resume Audio", or "Adjust Volume Only" selections.

Installation

Install via NPM globally:

sudo npm install -g --unsafe-perm homebridge-volumio-speakers

Alternatively you can install this through Homebridge Config UI X. Just search for homebridge-volumio-speakers.

Take a look at the Homebridge Wiki for help installing Homebridge if you haven't already.

Configuration

Use the Homebridge Config UI X Settings link, or add the Volumio Speakers platform manually to your config.json:

{
  "platforms": [
    {
      "platform": "Volumio Speakers",
      "serverURL": "http://volumio.local",
      "serverPort": 3000,
      "makeDummySensor": false
    }
  ]
}

You can use the following options in your homebridge config:

Variable	Optional/Required	Description
`platform`	required	Must be `Volumio Speakers`.
`serverURL`	required	The url of one of your Volumio servers. Other servers/zones will be auto discovered from there.
`serverPort`	optional	The websocket port of one of your Volumio servers (Default 3000). You should only need this if you're doing some advanced networking
`makeDummySensor`	optional	Creates another sensor type accessory for each discovered Volumio Zone. The status of the sensor is true while media is playing. This is used for building automations triggered by Volumio playing music.

How to use

Once configured, restart Homebridge and keep an eye on the logs.

Then in the Homebridge logs, you should see all your zones get accessories created for them.

The final step is to add each output accessory to Homekit, manually. To do this:

In Homekit on iOS go to "Add accessory"
Then hit "I Don't Have a Code or Cannot Scan"
You should see all your outputs listed on "Nearby Accessories"
Hit the first one, then hit "Add anyway", then enter the code provided by Homebridge (check your Homebridge logs).
On the final screen, just hit "Done". You can now add the speaker to one of your rooms by long pressing it and using the edit cog.
Repeat for each zone and/or sensor.

mcclurec / homebridge-volumio-speakers