Media & entertainment

LinkPlay

linkplay

Built inLocal polling

The LinkPlay integration for Home Assistant allows you to control various media players based on the LinkPlay protocol. The integration supports auto-discovery on your local network through Zeroconf.

Documentation Source code

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

Entity	Shows up as	Note
`media_player`	Receiver	Needs its own HomeKit Bridge in accessory mode
`button`	Button (as a switch)
`select`	Mode picker (as switches)

What people report

LinkPlay speakers such as WiiM work locally. Grouping is not supported and some oddball devices lack required fields.

Works2
Partly works3

Device	In Home Assistant	What they said	Source
WiiM amp	Works	Chosen over Sonos and HiFiBerry; bring own speakers, solid Saved copy I switched to WiiM after trying hifiberry and Sonos. Sonos has some annoying networking quirks (making its own WiFi unless all units are wire or all are wireless, needing STP routing) and hifiberry is flaky like everything RPi based. WiiM amp pros are nice because I can bring my own speakers and they’re solid no matter how you send audio to them. Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.	Reddit comment · 2025-11
WiiM models	Works Local	Two more WiiM models added Saved copy Proposed change Add two WiiM models to the linkplay integration ## Type of change <!-- What type of change does your PR introduce to Home Assistant? NOTE: Please, check only 1! box! If your PR requires multiple boxes to be checked, you'll most likely need to split it i Excerpt saved from GitHub on 2026-10-23.	PR #130707 · 2024-11
Audiocast M5	Partly works Local	Group join fails; integration has no grouping support Saved copy The problem Hello, I can't join/unjoin my Audiocast M5 speakers between then and also between Audiocast M5 and Wiim mini when i try to call the action below it errors out. action: media_player.join target: entity_id: - media_player.large_left data: group_members: - media_player.large_right The error in logs regarding action call Logger: homeassistant.components.websocket_api.http.connection Source: components/media_player/init.py:1134 integration: Home Assistant WebSocket API (documentation, issues) First occurred: 7:36:46 PM (6 occurrences) Last logged: 7:37:38 PM [140260622084144] Error … Excerpt saved from GitHub on 2026-10-23.	Issue #125770 · 2024-09
Edifier MA3	Partly works Local	No mac field and invalid API JSON; fix PR added Saved copy @VergilGao Just tried to look up the "Edifier MA3", but couldn't find them. There is a model named "Edifier MR3", but this one doesn't have wifi and is therefor definitely not Linkplay-compatible as Linkplay is DLNA-based and only works via TCP/IP. Afaik, the only Speakers by Edifier supporting `Linkplay` are the `MS50-A` and the `S1000-W`. Imho this issue might be therefor invalid. If I'm missing smth, please correct me! Excerpt saved from GitHub on 2026-10-23.	Issue #135488 · 2025-01
WiiM Mini	Partly works Local	Works but no join/group support in the official integration Saved copy @silamon Thank you for clarifying, i was thinking about it but i was not sure. Regarding the player update error, i've found on wiim page an API guide https://www.wiimhome.com/pdf/HTTP%20API%20for%20WiiM%20Mini.pdf Logger: homeassistant.helpers.entity Source: helpers/entity.py:942 First occurred: 9:46:53 PM (1 occurrences) Last logged: 9:46:53 PM Update for media_player.small_dorm fails Traceback (most recent call last): File "/usr/local/lib/python3.12/site-packages/linkplay/utils.py", line 48, in session_call_api response = await session.get(url) ^^^^^^^^^^^^^^^^^^^^^^ File … Excerpt saved from GitHub on 2026-10-23.	Issue #125770 · 2024-09

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local polling

Talks to the device on your network, asking it for updates every so often.

Found automatically over

Bonjour (zeroconf)

Details

Installs (analytics)	6,611 (0.93%)
Added in	Home Assistant 2024.8
Set up in the UI	Yes
Maintainers	@Velleman

Brands that work through it

Home Assistant lists these brands as supported by LinkPlay.

ArtSound

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.