s-knibbs/snapcast-ha-player

Home Assistant custom integration to enable TTS playback through a snapcast server

Snapcast Player Home Assistant Integration

⚠️ Unfortunately, due to health issues I will not be able to maintain this integration in future, so your YMMV ⚠️

Simple integration designed to allow playback through a snapcast server (the built in snapcast integration doesn't support audio playback). Audio is streamed to snapcast using ffmpeg, which is preinstalled on HassOS.

Installation

Install via HACS or copy ./custom_components/snapcast_player/ to /config/custom_components/

Configuration Variables

key	required	example	description
platform	yes	snapcast_player	Platform name
host	yes	127.0.0.1	Hostname, IP address of the snapcast server. If snapcast is running on the same machine, this can also be the path to a pipe
name	no	multiroom_player	Entity name
port	no	4953	Port to stream audio to, default is 4953
start_delay	no	1s	Insert a delay at the stream start. This can prevent the start of TTS announcements being cut off

Example Config

media_player:
  - platform: snapcast_player
    host: 127.0.0.1
    start_delay: 1s

TODO

• Support modifying the play queue via the media_player.play_media service.

snapcast-ha-player's Issues

So how to we actually use this?

Installed via hacs, added the following to the config:

media_player:
  - platform: snapcast_player
    host: 127.0.0.1
    start_delay: 1s

Snapserver is running as an addon on HA.
Is there any additional configuration required on snapserver?

Here's what I use: https://github.com/rwjack/addon-snapserver-spotify
(I have also made the change locally to expose 4953)

When I go into media, select snapcast_player, and try google TTS, I get no output on my snapclient devices.

Add name config option

Add a name config option to set the entity name. Currently the entity name is hardcoded as snapcast_player. In theory this should make it possible to configure multiple player entities, connected to different servers.