Installation
Installation of the Home Assistant Integration
Note
Ensure the MA server is up and running properly with music and player providers added before trying to link it to HA via the integration
- Make sure that you have the Home Assistant Community Store installed.
- Within HACS, search for
Music Assistant
and click the entry in the search results. - Click the big (blue) button at the bottom for
Download
. - Click the button again and in the dialog make sure
Show beta versions
is selected if you want to use those versions. - Download the desired version
- Restart Home Assistant.
- The MA server will normally be discovered automatically by HA and you can just click on CONFIGURE.
- If for some reason you need to add the integration manually then go to HA Settings>>Devices & services>>Integrations and click the big
+ ADD INTEGRATION
button. Look for Music Assistant and click to add it. You will need to add the server IP and port (usually 8095). Look for the relevant line in the server logs. For example,Starting server on 172.30.32.1:8095
. - Click SUBMIT and the Music Assistant integration is ready for use.
Note
The HA integration will create new media_player entities for those player types which are supported natively by MA. To see the names of those players go to HA settings>>Devices & services>>Integrations>>Music Assistant
and view the entities. It is these players that need to be targeted in automations.
Installation of the Home Assistant Player Provider
Once the HA Integration is installed it is possible to stream to HA media player entities. In order to do that the HA Player Provider needs to be installed. However, first the Home Assistant Plug-in provider needs to be installed.
- Navigate to MA SETTINGS>>PROVIDERS and add the plug-in provider
- If using the Music Assistant add-on (i.e. HAOS), you wont need any server details, it should auto connect to the local HA instance
- If using the docker version of the MA server, you will be required to enter the URL to your HA instance and then authenticate
Next install the Home Assistant Player Provider
- You need the HA plug-in first before you can use/install this provider
- In the provider settings, you can select which players you want to utilise
- You can only use players that support "play_media", other players will be filtered out
- MA players will also be filtered out
Note
Features are most likely limited with these players. Always prefer a native player provider if it exists in MA as that is optimised
Actions
The integration adds four actions for use in scripts and automations.