[beta] MacOS volume control for WiiM

[v-kooistra]

WiiM Volume​

A native macOS menu bar app to control your WiiM speaker volume directly from your Mac — no browser, no phone needed.

Why I built this: When streaming via Tidal Connect (or any other Connect protocol), your Mac's volume keys don't control the WiiM — they only adjust the Mac's internal output. So every time I wanted to change the volume while working fullscreen, I had to grab my phone, switch to the streaming app, or open the WiiM desktop app. For something as simple as turning the volume down, that's way too many steps. This app puts WiiM volume control right in your menu bar and lets your keyboard volume keys do what they should.

Built for macOS Tahoe 26+ with Apple's Liquid Glass design.

Features​

• Menu bar control — "WiiM " in your menu bar with volume slider
• Keyboard volume keys — Captures F11/F12/Mute to control WiiM instead of Mac volume (toggle with ⌘K)
• Scroll on icon — Scroll wheel on the menu bar icon to adjust volume
• Auto-discovery — Finds WiiM devices on your network via Bonjour + API probing
• Now playing — Shows current track info (artist & title) from Tidal Connect, AirPlay, etc.
• Liquid Glass HUD — Native macOS volume overlay when using keyboard keys
• Configurable step — 1%, 2%, 3%, 5%, or 10% per key press
• Zero audio interference — Controls volume via WiiM's HTTPS API, no audio pipeline involved (bit-perfect output maintained)

Compatible Devices​

Any WiiM or Linkplay-based device with HTTPS API:

• WiiM Pro Plus
• WiiM Pro
• WiiM Mini
• WiiM Amp
• WiiM Ultra
• Other Linkplay-based speakers

Known bugs:

1. it's a beta. so no code-signing. so Gatekeeper warnings ("can't be opened because Apple cannot check it for malicious software") since it's ad-hoc signed. i'll apply for a full apple dev licence($100) once it's ready.
2. when re-installing you need to give the app permissions to control the keyboard.
3. no song control or other features just yet. didn't seem the need for it.
4. there is no support desk for this app. i'll try to visit this post sometimes.
5. if this is not allowed due to , i dunno legal stuff. feel free to delete this post or change the post' location - that's why we have mods
6. im sure im forgetting somethings. but hey first post.
7. if you use airplay, then this is not for you. because i wanted to have the full quality of the sound.

that's all!

Download:​

APP (BETA) : https://drive.google.com/file/d/1m4j1eO-XyHYstUuRbAaM8yj_-7l_cOmr -- click download.

SOURCE CODE + BUILD (needs xcode) : github coming soon

Requirements​

• macOS 26.0 (Tahoe) or later
• Apple Silicon or Intel Mac
• WiiM device on the same local network. duh.

 

[Fletcher Munson]

Nice work ! Works fine on my mac mini and Wiim pro plus
Now playing is cool
The volume control is a bit more responsive than using spotify too
It would be nice to have play pause and skip
Impressive

 

[v-kooistra]

Update:

feature: Working on the update, to include the skip pause and play options.
fixed bug: mute , didn't work due to api implementation; toggle vs set:0
feature: icon added

 

[Doublej]

Looks great. Unfortunately I can't run Tahoe on my old Intel iMac.

 

[v-kooistra]

Looks great. Unfortunately I can't run Tahoe on my old Intel iMac.

fixed. issue was Liquid glass. It now supports macOS 13 or higher : Ventura.
You may need to remove and re-add the app in Accessibility settings, since the binary signature changes.

 

[cc_rider]

Very nice. Always great to see people innovating and solving problems for the WiiMs. Look forward to your github drop, to see how it's done!

 

[EddNog]

https://imgur.com/a/9hfpaTt

 

[reniro]

great idea and thanks for your work!
Sadly it won't find my Wiim Ultra in W-Lan.
Not visible on older iMac and M2 MacBook but at the same time the Wiim Home App can find it and connects with it.

 

[Doublej]

great idea and thanks for your work!
Sadly it won't find my Wiim Ultra in W-Lan.
Not visible on older iMac and M2 MacBook but at the same time the Wiim Home App can find it and connects with it.

Same here. The app sees my Pro Plus but not my Ultra. At the same time the WiiM Home App see both my Pro Plus and Ultra.

Note that my Wiim Ultra is running firmware version 5.2.719053 with a build date of 20250604. WiiM downgraded me to this version to 'fix' Chromecast not working on my Ultra.

 

[v-kooistra]

great idea and thanks for your work!
Sadly it won't find my Wiim Ultra in W-Lan.
Not visible on older iMac and M2 MacBook but at the same time the Wiim Home App can find it and connects with it.

Ultra doesn't have Airplay.

Same here. The app sees my Pro Plus but not my Ultra. At the same time the WiiM Home App see both my Pro Plus and Ultra.

Note that my Wiim Ultra is running firmware version 5.2.719053 with a build date of 20250604. WiiM downgraded me to this version to 'fix' Chromecast not working on my Ultra.

Ultra doesn't have Airplay.

fixed: Ultra WiiM / Chromecast only support. Let me know if it works. since i don't have a Ultra my self (i should get developer discount on the hardware *hint hint*). And as fallback you can enter the ip address of the device manually.

new version is online @ https://drive.google.com/file/d/1m4j1eO-XyHYstUuRbAaM8yj_-7l_cOmr

 

[Doublej]

Ultra doesn't have Airplay.


Ultra doesn't have Airplay.

fixed: Ultra WiiM / Chromecast only support. Let me know if it works. since i don't have a Ultra my self (i should get developer discount on the hardware *hint hint*). And as fallback you can enter the ip address of the device manually.

new version is online @ https://drive.google.com/file/d/1m4j1eO-XyHYstUuRbAaM8yj_-7l_cOmr

Please clarify. I don't understand how AirPlay is involved in controlling the volume of my WiiM Ultra from a Mac. I thought your app is remapping the volume keys on Mac keyboard to control the chosen WiiM's volume using the WiiM API?

I entered the Ultra IP address, restarted the app and now the Ultra appears on the list of WiiM devices. For some reason I have to select the Capture Media Keys twice before a check mark is played to the left of Capture Media Keys menu item and the keyboard media keys are able to control one of my WiiMs.

Also when I launch app the app icon does not appear in the dock bar.

 

[reniro]

yes now it works! Great Update

 

[v-kooistra]

Please clarify. I don't understand how AirPlay is involved in controlling the volume of my WiiM Ultra from a Mac. I thought your app is remapping the volume keys on Mac keyboard to control the chosen WiiM's volume using the WiiM API?

I entered the Ultra IP address, restarted the app and now the Ultra appears on the list of WiiM devices. For some reason I have to select the Capture Media Keys twice before a check mark is played to the left of Capture Media Keys menu item and the keyboard media keys are able to control one of my WiiMs.

Also when I launch app the app icon does not appear in the dock bar.

Happy to explain:

1. Discovery, on how the app 'finds' the devices:
WiiM Ultra doesn't have AirPlay — it only has Chromecast.
The original code only scanned _airplay._tcp Bonjour services in your LAN (since this has the nicest displayname convention), so:

Device	AirPlay	Chromecast	Was discovered?
Pro	✓	✓	✓
Pro Plus	✓	✓	✓
Mini	✓	✗	✓
Amp	✓	✓	✓
Ultra	✗	✓	✗
Amp Pro	✗	✓	✗

Fix: Also scan _googlecast._tcp + SSDP/UPnP as fallback. Now all devices get found. The HTTP API is not 'discoverable' , unless I scan the whole ip-segment LAN /24 or even bigger. And tought that would be a bit to invasive, maybe 'arp'.

2. BUG : the capture keys

You are right. when loading the app, it doesn't check if it's already connected to your keys. only when you toggle the 'button' it starts to work. this is to be fixed in the next version.

3. Feature : Manually

When connecting via IP, it should remember the device. not sure if that works. but now that the discovery is fixed. no need.

4. Feature : App in bar.

App doesnt have a icon in the Dock. Because I want my dock to be as clean. Design follows, so called: 'deamons' in taskbar. Maybe for the future i'll add a option to 'toggle' app in dock. Known BUG: when you close the taskbar app via 'quit WiiM Volume' the app doesn't always close. i'm looking into this.

 

[xonbul]

I've built something similar for myself (see here). Can you share your repo or a dmg install? I'd like to take a look. Thank you!!

 

[v-kooistra]

I've built something similar for myself (see here). Can you share your repo or a dmg install? I'd like to take a look. Thank you!!

WiiM Volume - Download

it's indeed very similar! i just couldn't find yours to skip my own dev .

 

[azoriusmage]

Works fine but would be nice if I change volume on the master of a group it changes the group volume.

 

[EddNog]

Works fine but would be nice if I change volume on the master of a group it changes the group volume.

I haven't used grouping in a long time, but last time I did, this was exactly how it worked for me.

-Ed

 

[azoriusmage]

I haven't used grouping in a long time, but last time I did, this was exactly how it worked for me.

-Ed

Well if you haven't used it for a long time perhaps trust someone who does like me to know what I am saying

 

[xonbul]

WiiM Volume - Download

it's indeed very similar! i just couldn't find yours to skip my own dev .

thanks!

 

[EddNog]

Well if you haven't used it for a long time perhaps trust someone who does like me to know what I am saying

I wasn't taking a dig at you. I am pointing out that something isn't actually working right--did you submit a ticket in the app?

-Ed

EDIT: Actually, never mind--perhaps there is something about using this third party remote volume control app (as opposed to using the physical remote control or using the native WiiM Home App on mobile device/tablet) that results in a different functioning result. The dev of the tool will need to opine--I am in a lot of threads on this forum and forgot the context of the thread. That being said, what I was talking about only applies to controlling volume via an official method, so feel free to ignore me.