Skip to content
Home Assistant TestFlight
Media & entertainment

WiiM

wiim

Built inLocal pushPlatinum

The WiiM integration allows you to control different WiiM devices from Home Assistant.

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
media_playerMedia player (as switches)Only TVs and receivers get a TV tile; other players show as power and play switches; Needs its own HomeKit Bridge in accessory mode

What people report

WiiM devices are supported locally. AudioPro C10 and C10 MKII WiiM editions are not discovered.

  • Works11
  • Not working1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
AudioPro A10 WiiM editionWorks LocalDiscovered quickly by the integration
Saved copy
The problem I have both an AudioPro A10 WiiM edition and an AudioPro C10 WiiM edition, the A10 gets discovered by the HA Integration very quickly but the C10 never gets discovered. Using IP to connect gives "Failed to connect", logs are saying that "does not appear to be a WiiM device." Installing the HACS WiiM Audio Integration (that replaces this native integration when installed) is however able to discover the C10 quickly. https://github.com/mjcumming/wiim The C10 was factory reset thrice, multiple delete and re-add of the WiiM devices in Home Assistant and Music Assistant. Both speakers …

Excerpt saved from GitHub on 2026-10-23.

Issue #168746 · 2026-04
WiiM AmpWorks LocalListed as supported; auto-discovered
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM Amp ProWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM Amp UltraWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM CI MOD A80Works LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM CI MOD SWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM MiniWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM Mini streamerWorksUsed with stereo gear; 16 WiiM amps also used for TTS
Saved copy
I can't stand smart speakers. They all sound like tinny garbage, I use WiiM minis connected to actual stereo components. I suppose you could stay with a smart speaker, but connect it to something that's meant to play music. Echo Dots are probably fine if you plug them into an actual stereo. You can get very good sound out of an inexpensive amplifier, modest speakers, and a small subwoofer.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2025-05
WiiM ProWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM Pro PlusWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
WiiM UltraWorks LocalListed as supported
Saved copy
Supported devices: WiiM Mini; WiiM Pro; WiiM Pro Plus; WiiM Amp; WiiM Amp Pro; WiiM Ultra; WiiM Amp Ultra; WiiM CI MOD S; WiiM CI MOD A80. Limitations: The integration only supports devices reachable on the local network. Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source. Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available. Authentication and cloud account features from the WiiM app are not used by this integration.

Excerpt saved from home-assistant.io on 2026-10-23.

Docs
AudioPro C10 WiiM editionNot working LocalNot recognized as WiiM device; Failed to connect; HACS integration finds it
Saved copy
The problem I have both an AudioPro A10 WiiM edition and an AudioPro C10 WiiM edition, the A10 gets discovered by the HA Integration very quickly but the C10 never gets discovered. Using IP to connect gives "Failed to connect", logs are saying that "does not appear to be a WiiM device." Installing the HACS WiiM Audio Integration (that replaces this native integration when installed) is however able to discover the C10 quickly. https://github.com/mjcumming/wiim The C10 was factory reset thrice, multiple delete and re-add of the WiiM devices in Home Assistant and Music Assistant. Both speakers …

Excerpt saved from GitHub on 2026-10-23.

Issue #168746 · 2026-04

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Found automatically over

  • Bonjour (zeroconf)

Details

Installs (analytics)5,214 (0.74%)
Quality scalePlatinum
Added inHome Assistant 2026.4
Set up in the UIYes
Maintainers@Linkplay2020

Devices listed in its documentation

  • WiiM Mini
  • WiiM Pro
  • WiiM Pro Plus
  • WiiM Amp
  • WiiM Amp Pro
  • WiiM Ultra
  • WiiM Amp Ultra
  • WiiM CI MOD S
  • WiiM CI MOD A80

Limitations from the docs

  • The integration only supports devices reachable on the local network.
  • Some playback sources expose limited transport capabilities, so next, previous, repeat, or shuffle controls may appear or disappear depending on the active source.
  • Direct URL playback and Home Assistant media source browsing require the device HTTP API to be available.
  • Authentication and cloud account features from the WiiM app are not used by this integration.

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.