Multiroom API Limitations and Feature Request

Boggy

New member
Joined
Dec 13, 2024
Messages
2
Hello WiiM Community,


I'm working on a Home Assistant dashboard for a multi-room audio setup using WiiM Amp Pro, and I've encountered some significant API limitations that are preventing a truly seamless multiroom experience.


Current Setup:
  • Multiple rooms with WiiM Amp Pro
  • Home Assistant dashboard for control
  • Existing API capabilities:
    • Change individual amp sources
    • Adjust volume per amplifier
    • Remove rooms from a linked group

Specific API Limitations:

  1. Unable to programmatically:
    • Change master/slave sources in a group
    • Dynamically link/unlink grouped devices
    • Manage complex multiroom configurations
Requested API Enhancements:
  • Add endpoints/methods to:
    • Set master device in a group
    • Synchronize sources across grouped devices
    • Dynamically link and unlink amplifiers
    • Provide more granular multiroom control
Use Case Example:Imagine wanting to:
  • Switch all grouped rooms to a single source
  • Change the master device in real-time
  • Create/modify groups on-the-fly
  • Implement complex audio routing scenarios
I've confirmed these limitations through direct API interaction and would love to hear:
  • If others are experiencing similar challenges
  • Potential workarounds
  • Interest in expanding the API capabilities

Open to collaborating on integration improvements or feature development.


Thoughts and insights welcome!
 
Upvote 4
I've deeply integrated my Wiim amp and 5 other Linkplay speakers into Home Assistant. My setup includes several custom automations and scripts - setting default volumes when speakers join groups, managing group volume presets, lots of Spotify stuff and conditional source switching, among others.

While there's a new native Linkplay integration available, I'm still using the old HACS integration since many features in the native one aren't functioning for my needs. Since the HACS version doesn't support Home Assistant's default join service, I had to create my own UI from scratch for grouping. The whole setup was quite time-consuming and might be more effort than most people want to invest, but I the end result is pretty awesome.

I tried to automate things like turning my sub on/off at night and dynamically setting equalizers via the API, but could not really find what I was looking for.

Screenshot_2025-02-03-19-33-14-124_io.homeassistant.companion.android-edit.jpg
IMG_20250203_193940.jpg
 
I don't use multi-room capabilities of my WiiM, but if you look here:

http://[Your WiiM IP]:49152/upnp/rendercontrolSCPD.xml

You'll find these actions, among many others:

MultiRoomJoinGroup
MultiRoomLeaveGroup
 
it would also be great to be able to get the playing status / metadata from a slave device, or at least get the information of what master device it is linked to to retrieve that information from
 
it would also be great to be able to get the playing status / metadata from a slave device, or at least get the information of what master device it is linked to to retrieve that information from
Isn't that what you get in the Devices tab in the WiiM Home App and for the Ultra also on the display?
 
Back
Top