KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #ai #dsh-plugin #ai-agent #mcp #deepseek-harness #windows

ambient_music

★ 60 Open GitHub ↗

Ambient Music Integration for Home Assistant

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Static Badge](https://img.shields.io/badge/HACS-Custom-41BDF5?style=for-the-badge&logo=homeassistantcommunitystore&logoColor=white)](https://github.com/hacs/integration) 
![Dynamic JSON Badge](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fanalytics.home-assistant.io%2Fcustom_integrations.json&query=%24.ambient_music.total&style=for-the-badge&label=Installs&color=brightgreen)
![GitHub Release](https://img.shields.io/github/v/release/connochio/ambient_music?style=for-the-badge&label=Current%20Release&color=41BDF5&cacheSeconds=15600)
![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/connochio/ambient_music?style=for-the-badge)

# Ambient Music

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

> [!IMPORTANT]
> This integration relies on Music Assistant, and will not work correctly without it.

> [!TIP]
> We are working on adding support for more providers playlist URLs with each release, but if you would like to request a specific provider please log a GitHub Issue via the feature request option.

## Installation

[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=connochio&repository=ambient_music&category=Integration)

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
- Deezer
- Qobuz

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

<details>
 <summary>Planned future helpers, switches and/or user-configurable settings</summary>
 
 
 - 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.
</details>

> [!IMPORTANT]
> This integration requires the use of automations to function.  
> These are available in the documentation below.

## Setup and Documentation

Setup and documentation can be found in the below link:

[Setup and Documentation Information](https://github.com/connochio/ambient_music_documentation#readme)

## Credits and Thanks

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

ambient_music

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README