Immich and Music Assistant

Provider connections

Named connections are stored under RustyHAMA → Providers. An Immich provider contains ID, URL and api_key; a Music Assistant provider contains ID, URL and token. Secrets live only in private HA storage, are redacted from diagnostics and are never read back by the panel or sent to Android. Multiple connections can represent separate user libraries.

Bindings

Profiles reference only provider_id or connection_id. Device-specific provider_bindings may map a logical name to another connection. An unknown provider reference blocks publication, so no configuration can fail with a missing secret only after reaching the device.

{"provider_bindings":{"family-photos":"immich-family","music":"ma-main"}}

Immich

Search and metadata use allowed Immich endpoints through the HA proxy. Asset previews are streamed authenticated through HA. Asset search, metadata search and thumbnails are allowed only for a connection bound by the effective dashboard. Android sees neither URL credentials nor API key.

Music Assistant

RustyHAMA primarily uses the official MA integration, HA entities and HA actions. A contained adapter adds search, library, covers and queue where no normal HA feature exists. The special type: "music_assistant" tab offers catalogue search, album/artist/playlist/audiobook, player selection, queue and playback; normal players remain controllable through media_player.