Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 1.98 KB

README.md

File metadata and controls

42 lines (30 loc) · 1.98 KB

AmpliPi Plugin for Home Assistant

This component adds support for auto-discovery and configuration of AmpliPi Groups and Zones.

If you like this component, please give it a star on github.

Installation

  1. Ensure that HACS is installed.
  2. Navigate to HACS on the sidebar and open the HACS settings by selecting the three dots icon. From there select "custom repositories". Step 2
  3. A dialog box should appear. In it, paste a link to to this repo, found at https://github.com/micro-nova/hacs_amplipi, under "Repository." Under "Category," select "Integration." Then click "Add." Step 3
  4. This will add the AmpliPi repository to your version of the HACS store! Search for it in the search bar and then click on it when it pops up. Step 4
  5. On the store page, click "Download" to install the integration. Step 5
  6. After the integration finishes installing, you will need to restart your Home Assistant. To do this, navigate to your Home Assistant's settings on the sidebar, then click the "Restart required." Your HomeAssistant will then reboot. Step 6
  7. AmpliPi integration should auto-discover your AmpliPi, and prompt you to configure the integration.

In case you would like to install manually:

  1. Copy the folder custom_components/amplipi to custom_components in your Home Assistant config folder.
  2. AmpliPi integration should auto-discover your AmpliPi, and prompt you to configure the integration

AmpliPi devices do not report a distinct identifier, so this integration currently only supports one controller per installation.

Each Zone and Group will be auto-discovered and a separate media_player entity will be created per zone.

The AmpliPi Media Player entities support:

  • Play
  • Pause
  • Off
  • On
  • PA

Credits

Cursor graphics used in this document from Freepik.