Innosonix Amplifier integration for Home Assistant

A Home Assistant integration that reads status information from Innosonix amplifiers (MAXX series) over the built-in REST API, built on top of the standalone innosonix Python client library published on PyPI.

Features

• Device info sensors: model, serial number, software revision, channel count
• Device sensors: master volume, PSU voltage, PSU load
• Device health: error / warning problem binary sensors
• Per-channel switches: amplifier enable and mute (all channels)
• Per-channel volume: number entity in dB (all channels)
• Configurable API key (defaults to the key shipped with the amplifier)
• Local polling, no cloud required

The Python client library

The innosonix package (src/innosonix) is a standalone async client for the Innosonix REST API and works independently of Home Assistant:

pip install innosonix

import asyncio
import aiohttp
from innosonix import InnosonixApiClient

async def main():
    async with aiohttp.ClientSession() as session:
        client = InnosonixApiClient("192.168.1.50", session=session)
        device = await client.get_device_infos()
        print(device.model_name, device.sw_revision)
        print("master volume (dB):", await client.get_master_volume())
        print("psu:", await client.get_psu_status())
        channels = await client.get_channels()
        for ch in channels:
            print(ch.channel_id, ch.name, ch.amp_enabled, ch.muted, ch.volume)
        await client.set_channel_muted(1, True)
        await client.set_channel_volume(1, -6.0)

asyncio.run(main())

The Home Assistant integration lists the library as a requirement, so Home Assistant installs it from PyPI automatically during setup.

Installation

HACS

1. Open HACS in Home Assistant.
2. Go to Integrations → ⋯ → Custom Repositories.
3. Add this repository's URL and choose the Integration category.
4. Find Innosonix Amplifier in HACS and install it.
5. Restart Home Assistant.

Manual

Copy the custom_components/innosonix folder into the custom_components folder of your Home Assistant configuration directory, then restart Home Assistant.

Setup

1. In Home Assistant, open Settings → Devices & Services → Add Integration.
2. Search for Innosonix Amplifier.
3. Enter the host name or IP address of your amplifier (e.g. 192.168.1.50).
4. Optionally enter a custom API key.
5. Finish the flow.

Requirements

• Home Assistant 2024.12 or newer