Is the WiiM integration fully local?

Yes for control. The wiim integration uses local push communication and needs no cloud account to run a device, so power, volume, source, and grouping all work offline. Streaming services still pull their content from the internet, and setup uses the WiiM Home app and a WiiM account that Home Assistant control does not need afterward.

Why does one WiiM speaker show up several times in Home Assistant?

Depending on the model, a single WiiM unit can be visible to the wiim, linkplay, cast, and dlna_dmr integrations at the same time. If more than one is enabled, Home Assistant adds a separate media_player for each. The Mini has no Google Cast, so it tops out at three. Add the device through the wiim integration only and ignore the others so you get a single entity.

Which WiiM devices support AirPlay 2?

The Mini, Pro, Pro Plus, and Amp support AirPlay 2. The Ultra, Amp Pro, Amp Ultra, Sound, and Sound Lite do not, and the Ultra's omission is a hardware limitation that cannot be patched later. On the models without AirPlay, use Google Cast or Bluetooth for Apple devices.

WiiM & Home Assistant

Audio & Media

WiiM’s dedicated Home Assistant integration was added in Home Assistant 2026.4 and controls WiiM streamers, streaming amplifiers, and powered speakers locally over your network. It discovers each unit automatically and exposes each streaming endpoint as a media_player entity with power, volume, source selection, playback state, and multiroom grouping. System accessories such as the Sub Pro appear as part of the unit they belong to rather than as a media_player of their own. No cloud account is required for control.

The integration communicates locally using Local Push, so playback and grouping keep working without internet, though streaming services still fetch their content from the cloud. Most WiiM units are also visible to the older linkplay integration and to Google Cast or DLNA, though the exact overlap varies by model and the Mini has no Cast, so installers should standardize on the wiim integration and ignore the others. The integration is currently Bronze quality and still maturing, and setup uses the WiiM Home app and a WiiM account that Home Assistant control does not need afterward.

Local control No cloud required

Selora WiiM devices Home Assistant

HA Documentation

How WiiM Works with Home Assistant

Getting WiiM connected to Home Assistant and running reliably.

1

Discover & connect

Home Assistant discovers WiiM media devices on your network automatically. Add them to see playback controls, volume, source selection, and grouping options.

2

Multi-room audio

Group WiiM speakers with devices from other brands for synchronized whole-home audio. Control each room independently or as zones.

3

Event-driven media

Build automations that play specific audio based on events — doorbell rings, morning alarms, or custom announcements. Route different media to different rooms.

Common WiiM Issues

The problems installers run into with WiiM and Home Assistant — and how a managed setup prevents them.

Duplicate entities from overlapping integrations

One WiiM unit answers to as many as four local integrations at once (wiim, linkplay, cast, and dlna_dmr). Enabling more than one creates duplicate media_player entities for the same speaker. Commit to the wiim integration and ignore the rest so each device appears once.

AirPlay 2 support varies by model

WiiM's newer touchscreen generation dropped AirPlay 2. The Ultra, Amp Pro, Amp Ultra, Sound, and Sound Lite do not support it, and the Ultra cannot add it because of a hardware limitation. The Mini, Pro, Pro Plus, and Amp still do. Plan Apple streaming around Google Cast or Bluetooth on the models without AirPlay.

Discovery drops after network changes

WiiM units are found over mDNS and UPnP. VLAN boundaries, client isolation on an access point, or IGMP snooping can hide them from Home Assistant, so the audio devices and the Home Assistant host need to share a discovery path.

New integration, still changing

The core wiim integration is Bronze quality and shipped in Home Assistant 2026.4, so some behavior lags the WiiM Home app and can change across releases. The legacy linkplay integration remains a local fallback when a model or feature is not yet covered.

Why installers choose managed WiiM audio

One integration per device (wiim only) so entities stay clean and never duplicate
Network configured for reliable mDNS and UPnP discovery across VLANs
Apple streaming matched to each model, with AirPlay where a device supports it and Google Cast or Bluetooth where it does not
Multiroom grouping and media automations tuned around the integration's current limits

Learn How We Manage WiiM

WiiM devices we deploy

Hardware from the Selora catalog that runs on this integration. Every unit is tested and supported as part of a managed installation.

View full WiiM catalog

Speakers & Audio

10 devices

Amp

WiiM

The WiiM Amp is a streaming amplifier that powers a pair of passive speakers and presents them to Home Assistant as one media_player. The wiim integration reports playback, volume, and source, and HDMI ARC lets the Amp handle TV audio too.

Amp Pro

WiiM

The WiiM Amp Pro is a streaming amplifier with an ESS DAC, room correction, and HDMI ARC. It powers passive speakers and presents them to Home Assistant as one media_player, with playback, volume, and source reported through the wiim integration.

Amp Ultra

WiiM

The WiiM Amp Ultra is a streaming amplifier rated at 100 watts per channel, with a touchscreen, room correction, and HDMI ARC. It powers passive speakers and presents them to Home Assistant as one media_player, with playback, volume, and source reported through the wiim integration.

Mini

WiiM

The WiiM Mini is a compact network streamer that adds a media_player to an existing amplifier or powered speakers through its 3.5mm and optical outputs. The wiim integration runs it locally and reports playback, volume, and source. No cloud account is needed for control.

Pro

WiiM

The WiiM Pro is a network streamer and preamp that brings an existing amplifier or active speakers into Home Assistant as a media_player. Through the wiim integration it reports playback, volume, and source, and it groups with other WiiM units for multiroom audio. Control stays on the local network.

Pro Plus

WiiM

The WiiM Pro Plus is a network streamer and preamp with an upgraded DAC. Home Assistant runs it as a media_player through the wiim integration, reporting playback, volume, and source, and it groups with other WiiM units for multiroom audio.

Sound

WiiM

The WiiM Sound is a powered smart speaker with a round touchscreen and room correction. Home Assistant runs it as a media_player through the wiim integration, reporting playback, volume, and source, and it groups with other WiiM units for multiroom audio.

Sound Lite

WiiM

The WiiM Sound Lite is a smaller, cheaper powered smart speaker. Home Assistant runs it as a media_player through the wiim integration, reporting playback, volume, and source, and it groups with other WiiM units for multiroom audio.

Sub Pro

WiiM

The WiiM Sub Pro is a wireless subwoofer that adds bass to a WiiM Sound or WiiM Amp system, or connects to other gear through its RCA input. In Home Assistant it shows up through the wiim integration as part of the system it belongs to, not as a source you send audio to.

Ultra

WiiM

The WiiM Ultra is a network streamer with a 3.5 inch touchscreen, an ESS DAC, a phono input, and HDMI ARC. It brings a turntable, a TV, and streaming services into Home Assistant as one media_player, with playback, volume, and source reported through the wiim integration and multiroom grouping across other WiiM units.