Back to the overview

WiiM in Home Assistant

wiim part of Home Assistant since 2026.4

Local, push Set up in the user interface Quality: Platinum

WiiM is an official Home Assistant integration for Media player. Talks to the device on your own network and is told about every change straight away.

Facts about this integration

Compatible with Home Assistant
yes, official integration
Connection
Local, push – Talks to the device on your own network and is told about every change straight away.
Setup
in the user interface
Kind
Single device
Quality scale
Platinum – The highest level: fully typed, efficient and maintained to every rule of the project.
Installations
4,569 (0.7 % of the installations that share statistics)
Categories
Media player
Provides
Diagnostics, Media player
Found automatically via
Network discovery (Zeroconf)
Maintained by
@Linkplay2020
Python packages
async-upnp-client==0.48.1, wiim==0.1.7

Setup

  1. Home Assistant can find this integration on its own: if it is suggested under Settings → Devices & services, confirm it there.
  2. In Home Assistant open Settings → Devices & services.
  3. Click "Add integration" and search for WiiM.
  4. Follow the dialog – it asks for everything the integration needs.

Add to my Home Assistant

The link goes through my.home-assistant.io and opens the setup dialog in your own instance – no address of ours is involved.

Community versions in HACS

These extensions use the same domain. Installed through HACS, one of them takes the place of the official integration – usually to bring a feature or a fix sooner. Remove it again once Home Assistant has caught up.

  • HACS WiiM Audio (LinkPlay) – WiiM (LinkPlay) Audio Integration for Home Assistant with multiroom support updated September 12, 2026 · Open in HACS · GitHub

Known issues and fixes

6 open issues and 5 bug fixes in the last twelve months are recorded for WiiM in the Home Assistant issue tracker. If something does not work, update first: the most recent fix shipped with Home Assistant 2026.4.1.

Open

  • open Reported problem #167452 since April 5, 2026 · 3 reactions · 8 comments · #167452
  • open Reported problem #168047 since April 12, 2026 · 1 reaction · 4 comments · #168047
  • open Reported problem #178453 since August 7, 2026 · 0 reactions · 3 comments · #178453
  • open Reported problem #178173 since August 4, 2026 · 0 reactions · 2 comments · #178173
  • open Reported problem #176031 since July 8, 2026 · 0 reactions · 2 comments · #176031
  • open Reported problem #176890 since July 20, 2026 · 0 reactions · 1 comment · #176890

Fixed

Source: the issue tracker of Home Assistant, as of September 16, 2026. The sentences are written by a language model from the titles of the issues; the reports themselves are on GitHub.

Check a specific device for known problems in the product check →

Source of this entry: the official documentation of the integration

Scroll to Top