Home Assistant is an open-source home automation platform that helps you control smart devices from different brands in one place.

WiiM integration is now officially supported by Home Assistant. With it, you can easily add your WiiM devices to Home Assistant, control playback, and automate audio routines through its intuitive interface.

WiiM integration is supported in Home Assistant version 2026.4 or above.

How to Add WiiM Devices to Home Assistant

Before You Begin
  • Install Home Assistant version 2026.4 or above, and run it. For details, see Installation - Home Assistant.
  • Ensure your WiiM device is set up via the WiiM Home app.
  • Ensure your WiiM device and the device running Home Assistant are connected to the same network.
  • Verify that your WiiM device is running the latest firmware to ensure compatibility with Home Assistant.
Quick Integration
  1. Open https://www.home-assistant.io/integrations/wiim/ in a web browser.
  2. Click the icon on the page to start the integration process.
  3. WiiM devices will be automatically discovered and appear as Discovered in Home Assistant.
Manual Integration

If your WiiM device is not discovered automatically, follow these steps to complete manual integration:

  1. Open a web browser on your PC to access Home Assistant at http://homeassistant.local:8123/.

    Alternatively, you can use the Home Assistant app on your mobile device to perform the following operations.

  2. Go to the Settings tab on the left sidebar. Your WiiM device will be automatically discovered.
  3. Click the Add button under your WiiM device to add it to Home Assistant.
  4. Optionally, assign your WiiM device to an area.
  5. Once added, your WiiM device will appear in the Overview tab.

Playback Control

After your WiiM device is successfully added to Home Assistant, start playing music on your WiiM device. Once playback begins, the Now Playing bar will appear in the Overview tab, allowing you to control playback.

In addition, click the three-dot icon (⋮) in the top-right corner of the Now Playing bar to open the full playback controls, as shown below:

Here, you can:

  • Play/Pause
  • Skip to the next or previous track.
  • Adjust the volume.
  • Enable shuffle mode or repeat mode.
  • Click to select the input source.
  • Click  to access presets and browse the playback queue.

Tips for Smooth Integration

  • Ensure your network is stable, as both Home Assistant and WiiM devices rely on network performance.
  • Regularly check for updates for both the Home Assistant system and WiiM devices to maintain compatibility.
  • If issues arise, consult a certified installer or contact WiiM support for further assistance.