WiiM/LinkPlay Integration - Beta Release

Third party integrations
1

Hey everyone! I’ve been working on an integration for WiiM and LinkPlay audio devices. It’s now in beta and ready for testing if you’re interested.

What is this?

This integration adds support for WiiM speakers (Mini, Pro, Pro Plus, Amp, Ultra) and other LinkPlay-compatible devices to Home Assistant. It focuses on making multiroom audio easier to manage.

Key Features

  • Multiroom audio with role detection (shows if speakers are grouped)
  • Virtual group player - single entity appears when you group speakers
  • EQ presets - switch between sound modes like Rock, Jazz, Classical
  • Media browser for presets and custom radio stations
  • Auto-discovery of devices on your network

Installation

Via HACS:

  1. Add custom repository: https://github.com/mjcumming/wiim
  2. Search for “WiiM Audio” and install

Manual: Download and extract to /config/custom_components/wiim/

Basic Setup

After installation, the integration should find your speakers automatically. If not, you can add them manually with their IP address.

Each speaker gets:

  • A media player entity
  • A role sensor (shows Solo/Master/Slave status)
  • A group coordinator entity when grouped

Looking for Feedback

This is a beta release, so I’m particularly interested in:

  • Multiroom grouping stability
  • Any devices that don’t work properly
  • Missing features you’d like to see
  • General bugs or issues

Documentation

Feel free to ask questions here or open issues on GitHub. Thanks for trying it out!

2

HI, thanks and this is one of multiple integrations that cover Linkplay/WiiM ( I only have WiiM ) and since there is also a Core integration with the same goals, why would people use this one and not the Core? Maybe a small comparison might help?

3

Here’s a quick comparison:

This integration focuses on:

  • Virtual group players - When you group speakers, a single media player entity appears to control the whole group
  • Better multiroom visibility - Role sensors show which speakers are Solo/Master/Slave
  • EQ control - Switch between presets (Rock, Jazz, etc.)
  • Quick Stations - Easy access to custom radio URLs via media browser
  • No external library dependencies

Both work well - this one just adds some quality-of-life features for multiroom users. Since you have WiiM devices, you could try both and see which workflow you prefer.

4

Thanks for the update, I only have 1 WiiM which I use as transport to my DAC so the Core part is sufficient for me, which btw does cover EQ (only for WiiM). I may try it for radio bit :slight_smile:

5

Just wanted to say thanks for sharing this integration. I have a bunch of Arylic devices and the core integration never showed the group status correctly when I synced my speakers through the 4stream app. In your integration it updates correctly which is amazing. Also because of this issues in the core integration pairing speakers through music assistant did not work correctly. Have not tried it yet with this integration but I hope it solves it.

The only thing that did not work for me was toggeling the Led on Arylic devices which is not a huge deal.

Thanks for the great work!

Edit: I just tried it with Music Assistant but for some reason only one media player from the Homeassistant Player Provider shows up. When I delete that specific player in the provider, another one shows up.