HomePod Connect: Spotify on HomePods with Spotify Connect

Share your Projects!
1

This addon allows you to play Spotify music on your HomePods.

250×100 4.66 KB

It is based on OwnTone and librespot. And can be integrated into Home Assistant with the OwnTone integration.

Please keep in mind that this addon is experimental. I have been using it myself for a long time without any major issue. But small audio drops (for like 1-10 seconds) are really common. So please do not report them.

Updating from an older version (28.x)

The image was rebuilt on the official OwnTone container and now uses librespot instead of librespot-java, since neither linuxserver/daapd nor librespot-java is maintained anymore. Two things to do after updating:

  • Select “Home Assistant” in Spotify once more. The old login cannot be reused.
  • If you customized librespot-java.toml, the settings moved to /config/owntone/librespot.conf. The old librespot-java.toml and credentials.json can be deleted.

Your owntone.conf is kept as it is.

Features

  • OwnTone & librespot inside one Docker image
  • Ready out of the box with zeroconf & Home Assistant integration
  • Control OwnTone through Home Assistant
  • Metadata support (visible in Home Assistant)
  • Fully customizable through the config files in /config/owntone

Requirements

  • A Spotify Premium account
  • At least one HomePod
  • Correct set up in the Home app
    • Home → Home Settings → Allow Speaker & TV Access → Anyone On the same Network
    • Home → Home Settings → Allow Speaker & TV Access → Require Password: Disabled
  • VSCode addon or any other text editor to edit the configuration

Limitations

  • You cannot control the playback through the HomePods. Only through Spotify. (Volume adjustments are possible, though)
  • Sometimes the addon becomes unresponsive. A restart should fix it.
  • The streams are maybe not in perfect sync. You will notice that if you have multiple HomePods in the same room.
  • Sometimes the playback stops for a few seconds and then continues afterwards. (Without issuing play/pause commands)

Installation

Download the addon: Open your Home Assistant instance and show the dashboard of a Supervisor add-on.

Install the integration: Open your Home Assistant instance and start setting up a new integration.

Configuration

You can use the VSCode add-on to customize the configuration.

You can configure OwnTone through its configuration file. It can be found at /config/owntone/owntone.conf.
librespot is configurable through /config/owntone/librespot.conf, where you can set the name shown in Spotify (LIBRESPOT_NAME) and any extra librespot flags (LIBRESPOT_OPTS), for example the audio quality, autoplay or the initial volume. The file lists the most useful ones.
After adjusting something, please restart the add-on.

There is no account to configure. Spotify dropped username/password logins, so you selehe device list in the Spotify app once and the add-on stays paired with that account. Topair it with a different account, stop the add-on, delete /config/owntone/librespot and select it again from there.

Access OwnTone

You can access OwnTone through [Home Assistant IP]:3689

OwnTone Credentials

Username: admin
Password: owntoneadmin8765

Automation

I also created a blueprint that can automatically start and stop music in different roode an occupancy or motion sensor.
Import the blueprint: Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.

Troubleshooting

I cannot see the Home Assistant speaker through Spotify Connect.

The speaker is announced over zeroconf/mDNS, so the device running Spotify has to be able to reach Home Assistant directly:

  • Both have to be on the same network. mDNS does not cross VLANs or subnets unless you
  • Client/AP isolation on the Wi-Fi has to be disabled.
  • Check the add-on log. It should show a line like librespot 0.8.0 shortly after the
  • Restart the add-on and close and reopen Spotify afterwards.

Providing your Spotify username and password is not possible anymore, Spotify removed that login method. The device list is the only way in.

References

2

Very nice, looking forward to using this addon to move away from my Portainer + linuxserver owntone docker container (about which HA OS is complaining my setup is unsupported).

I tried a-marcels addon earlier but he doesn’t maintain it.

I installed your addon and it runs, but during startup it logs
“Skipping library directory /media/Muziek, could not dereference: No such file or directory”

(since I added that as the music source dir in the owntone.conf file).
What do you suggest I could do?
That directory is owned by root but with 777 rights.
I noticed your owntone.conf also contains uid = “abc”, is that correct?

3

Hey @GoSpursGoNL,

this addon does not mount the media directory of HA OS. I guess that is the reason the directory is not found.

4

@GoSpursGoNL

I just updated the addon to mount the /media directory inside the addon. Hope this solves your issue.

5

It works, many thanks!!! Very happy with this addon.

6

Hi,

Firstly apologies as I have just joined the community and setting it up for the first time.
Just so I don’t start on the wrong path, I am after the option to start a playlist on my dashboard on Spotify and select that to be played on one or multiple homepods/mini’s.

Would this project or for me?

Thanks in advance

7

I get “This add-on is not compatible with the processor of your device or the operating system you have installed on your device.”

Most likely as I’m using a 32bit Pi 3. Any chance of a compatible version?

8

Best would be to install the 64-bit OS image of Home Assistant OS.

9

I guess.

I use it to start music from Spotify directly. It is not possible to select the playlist through home assistant directly. For that, I can recommend the normal Spotify integration. And then you can select the speaker through Spotify Connect. And in home assistant itself, it is possible to select the HomePod’s on which you want to listen to the music.

11

Hey I just wanted to say that this addon is really awesome. It just works as described.

But I would like to suggest a small change.
Could you add support for home assistants ingress feature? Introducing Hass.io Ingress - Home Assistant

Currently if you click “Open Web UI” it opens a separate tab and does not really work when using home assistant with a reverse proxy.

With ingress OwnTones web interface would open within the Home Assistant tab and credentials can be automatically fed with it.

12

Hey @alexbabel, this sounds like such a cool add-on! Unfortunately when adding the Integration using the OwnTone credentials you stated, I get the following error message: “Unable to connect. Please check host and port.” while using the port 3689. Any help is much appreciated :slight_smile:

13

Hey @HenryKleinschmidt,

unfortunately, I cannot add that feature. OwnTone uses more than one port to realize the web interface. The second port is used for a web socket connection. This type of setup is not supported through the ingress feature of Home Assistant.

I also would love to use OwnTone that way. But their web interface needs to be adjusted. (Web socket and Web interface must be accessible through the same port).

14

Hey @badabingbadabong,

this sound like the same issue as @HenryKleinschmidt described (usage of a reverse proxy). Please try to access OwnTone through the IP address of your Home Assistant device. e.g. 192.168.1.23:3689.

16

Is anyone else experiencing the Owntone cache folder endlessly growing? It gets to the point where it fills up the disk, forcing me to delete it. I’m not sure how to stop that from happening since I don’t see any documentation on this cache.

17

@maiorania

I would recommend disabling the cache entirely. (adjustable inside the librespot-java.toml)

[cache]
	dir = "/config/owntone/cache/"
	# Cache enabled
	enabled = false
	doCleanUp = true
18

Ah, thank you! I didn’t even think of looking in that config file.

19

I think there’s an issue with your container. I am unable to configure the owntone.conf file because every time the container is restarted, the conf file is set back to defaults.

20

Hello! Great work, thank you so much!
I had issues with discovery too, USER_PASS strategy worked and then it hit me…

I needed to edit: /config/owntone/librespot-java.toml

[zeroconf]
        listenAll = true

It was set to false initially. Now it is discoverable!

21

That was a bug in the addon that is now fixed: Addon with owntone 28.6 constantly changes owntone.conf · Issue #5 · AlexanderBabel/hassio-addons · GitHub

22

Great addon! Works greatly on my raspberry pi 4 and Home assistant. One question. I would like to generate multiple Spotify connect options, containing more or less speakers in my home. Like home assistant 1 would contain the speakers in the kitchen and living room, home assistant 2 would have others or additional.

Or: is there a similar addon that exposes an HomePod as Sonos service?