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
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?
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.
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
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.
Hi, not sure if known to you but the WiiM/LP company have initiated a complete new integration for WiiM in Core. No clue how much time it will take untill it gets reviewed/accepted…still… good to know I guess
Hey guys, can’t seem to find this functionality but does anyone know if this supports “Announcements” or at-least TTL from HomeAssistant to anything on the WiiM side?
I assuming if you can do a media_player.play_media to any of these WiiM devices you can forward anything from Homeassistant? (e.g. Creating a TTL then forwarding the URL to that message to be spoken aloud)
Hello, looks great so far! One thing I miss from the Linkplay integration method is the output audio hardware. I frequently have to change from Optical to Line In and it would be good to have that capability.
@mjcumming I built something for the Linkplay/Core integration, the devs ‘forced’ me to create this as a sensor, you can have a look there if you want to add it. I would normally be happy to raise a PR but I myself am not spending time until I know how the new core-wiim integration looks like, there is movement but it takes time (as most in core)
just want to say thank you. You should spread the word in the simon42 community because many people don’t know that you can use it to create a multiroom system with inexpensive speakers.
I have some issues:
1.) FritzBox (DSL Router with integrated DLNA Server) is detected as WiiM device but cannot be activated. (no idea why this is detected as WiiM device)
2.) have two media players with my speaker. One is working the other one not available
Transform your WiiM and LinkPlay speakers into powerful Home Assistant media players with full multiroom support. Built on the brand new, fully async pywiim library we wrote for reliable, high-performance device communication.
Why Choose This Integration?
Complete Media Control - Full transport controls, volume, sources, presets, TTS, and media browsing
True Multiroom - Uses Home Assistant’s native grouping for reliable synchronized playback
Powered by pywiim - Built on the brand new, fully async pywiim library we wrote for robust, high-performance device communication
Auto-Discovery - Finds speakers automatically via UPnP/SSDP/Zeroconf
Universal Compatibility - Works with all Home Assistant dashboards, voice assistants, and media sources
Hybrid State Updates - UPnP events for real-time updates + HTTP polling for reliability
Advanced Audio - 10-band EQ, audio quality sensors, output mode control, and format support
Timer & Alarms - Sleep timer and alarm management for WiiM devices
Rich Diagnostics - Comprehensive statistics, health monitoring, and troubleshooting tools
Scene Support - Full scene restoration including EQ presets and playback state
Smart Features - Optimistic UI updates, adaptive polling, and intelligent source detection
Supported Devices
WiiM: Mini, Pro, Pro Plus, Amp, Ultra
LinkPlay Compatible: Arylic, Audio Pro (including Gen1: A26, C10, C5a and MkII models), Dayton Audio, DOSS, and many more
Enhanced Compatibility: Automatic protocol fallback for devices with non-standard configurations
Requirements: Home Assistant 2024.12.0+ on same network as speakers
Quick Start
1. Install via HACS (Recommended)
Find in HACS: HACS → Integrations → Search “WiiM Audio”
I was wondering whether you might have any plans to add a LinkPlay player provider for music assistant based on pywiim? My sense is that for a real good music experience, the “best” strategy at the moment is to have a player provider in MA and then it will show up in HA automatically as a MA player.
@mjcumming I was using the media_content_id attribute that was introduced in V 1.0.33 to identify internet radio stations and found this very useful. This attribute has disappeared. Any chance to bring it back?
Can this pickup “Standby” status? Trying to automate something which requires the WiiM Ultra to be placed into Standby but HA can only pick up the following status - t’s turn on, turn off, becomes idle, starts buffering, is paused, starts playing, restart has been pressed
Yeah I’m really not sure what is best practice to set all of this up, as I seem to end up with multiples and overlap. Do I disable the built in Linkplay integration completely and just have this one, or is it best to have both running? Do entity or group related settings in MA then duplicate HA?
Separately to the above, I’ve got an ongoing frustration with some Linkplay speakers that are battery powered, but even if plugged in they go to sleep/standby and need a physical push on the on button to turn back on. Really annoying, and I’m not sure if there’s anything that can be done about it? Also causes endless refresh and log errors in HA as the devices come and go.
Further to the above, I came across this that suggests the MA Wiim/Linkplay integration will be separate to this integration or the underlying library.
I tested your component on my Arylic streamers, and when playing Spotify, the player doesn’t display cover art (just like with the official integration). Is this expected behavior?
A long time ago, the nagyrobi integration handled this functionality.
Complete Media Control - Full transport controls, volume, sources, presets, TTS, and media browsing
True Multiroom - Uses Home Assistant’s native grouping for reliable synchronized playback
Powered by pywiim - Built on the brand new, fully async 
Auto-Discovery - Finds speakers automatically via UPnP/SSDP/Zeroconf
Universal Compatibility - Works with all Home Assistant dashboards, voice assistants, and media sources
Advanced Audio - 10-band EQ, audio quality sensors, output mode control, and format support
Timer & Alarms - Sleep timer and alarm management for WiiM devices
Rich Diagnostics - Comprehensive statistics, health monitoring, and troubleshooting tools
Scene Support - Full scene restoration including EQ presets and playback state
Smart Features - Optimistic UI updates, adaptive polling, and intelligent source detection
Multiroom & Grouping
Advanced Features