Skip to content

Turn your Home Assistant instance into a jukebox, hassle free streaming of your favorite media to Home Assistant media players.

License

Notifications You must be signed in to change notification settings

music-assistant/hass-music-assistant

Repository files navigation

Music Assistant

latest version discord hacs sponsor

Turn your Home Assistant instance into a jukebox, hassle free streaming of your favourite media to Home Assistant media players.

Introduction

Music Assistant is a music library manager for your offline and online music sources, combined with the power of Home Assistant to easily stream your favourite music to a wide range of supported players.

Music Assistant consists of multiple building blocks:

  • Music Assistant Server (2.0): the core part that runs the Music Assistant engine and keeps track of your Music sources. This will be installed automatically as an addon in HAOS when installing the Integration. Alternatively, you can manually install the addon in HAOS or install the server in a separate docker container.
  • Music Assistant integration for Home Assistant: Connects Home Assistant to your Music Assistant Server to automate your music!
  • Home Assistant Plugin for Music Assistant: Import Home Assistant media players into the Music Assistant engine to use as targets for playback.

Documentation

See here https://music-assistant.io

Installation of the Music Assistant Server

MA requires a 64bit Operating System and a minimum of 2GB of RAM on the physical device or the container (physical devices are recommended to have 4GB+ if they are running anything else)

Installation instructions are here https://music-assistant.io/installation/

Installation of the Home Assistant integration

See here https://music-assistant.io/integration/installation/

OpenAI features

During Chapter 5 of "Year of the Voice", JLo showed something he had been working on to use the OpenAI integration along with Music Assistant. We now have this feature baked in to the integration code directly, although some extra setup is still required.

See the instructions here https://music-assistant.io/integration/installation/#openai-features

I need help, I have feedback

  • Documentation
  • Issue tracker to create bug reports, please include detailed info and logfiles. Please check if your issue has already been reported.
  • Feature requests: Give your vote to an existing request, join the discussion or add a new request.
  • Q&A section Frequently asked questions and tutorials
  • Discord community Join the community and get support!

I want to help

See here https://music-assistant.io/help/