Skip to content

connochio/ambient_music

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Static Badge Dynamic JSON Badge GitHub Release GitHub Issues or Pull Requests

Ambient Music

A Home Assistant integration for playing ambient music on supported players via Music Assistant.

Important

This integration relies on Music Assistant, and may not work correctly without it.

Tip

Whilst this integration is quite new, only some providers are currently supported.
These are:

  • Spotify
  • Youtube Music
  • Local Files via Music Assistant
  • Plex Media Server (via MASS)
  • Tidal
  • Apple Music

We are working on adding more with each release, but if you would like to request a specific provider please log a GitHub Issue and tag it as a feature request.


Installation

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Install this integration via HACS with the link above.


Description

An integration that enables automatic playback of music via Home Assistant

The currently supported music providers are:

  • Spotify
  • Youtube Music
  • Music Assistant Local Files
  • Plex Media Server (via MASS)
  • Tidal
  • Apple Music

When configured, playlists will fade out and back in from each-other seamlessly when changed, and fade in and out when Ambient Music is turned on or off.

User configurable options include:

  • Default volume
  • Music fade in time
  • Music fade out time
  • Time to wait between swapping playlists
  • Playlist names and spotify IDs
  • Blockers to prevent Ambient Music from running
    • available via either entity selection or template
Planned future helpers, switches and/or user-configurable settings
  • Configurable sleep mode.
    • Sleep mode will play a user-selected playlist at night, based on user-set time of day binary sensors.
      This will override any currently selected playlist.
  • Configurable hours
    • Ambient music will play only during set hours, based on user-set time of day binary sensors.

Important

This integration requires the use of automations to function.
These are available in the documentation below.


Setup and Documentation

To get this integration fully up and running, a small amount of setup is needed.
Setup instructions and automation blueprints can be found within the documentation guthub page below:

Setup and Documentation Information


Credits and Thanks

Special thanks to Lauren Peploe for her design and creation of the Ambient Music logo