2026.4.0
Home ▸ Integrations

WiiM

The WiiM integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to control different WiiM devices from Home Assistant.

Configuration

To add the WiiM hub to your Home Assistant instance, use this My button:

WiiM can be auto-discovered by Home Assistant. If an instance was found, it will be shown as Discovered. You can then set it up right away.

Manual configuration steps

If it wasn’t discovered automatically, don’t worry! You can set up a manual integration entry:

Supported functionality

Media Player

The media player entity gives you complete control over your WiiM device from Home Assistant. In addition to standard playback functionality, it offers:

  • Playback controls: Control playback state, skip tracks, adjust volume, seek, select sound modes, and set repeat or shuffle modes directly from the Home Assistant UI or automations.

  • Multiroom Audio: Seamlessly group multiple WiiM devices to create synchronized multiroom playback. Use the standard Home Assistant services: media_player.join and media_player.unjoin.

  • Media Browsing: Browse presets, playlists, and the device’s current playback queue, enabling dynamic selection of media from the Home Assistant interface.

Buttons

The button entities provide some additional WiiM features available on the device:

  • Time Sync: Synchronizes the device’s internal clock with the current time on your Home Assistant server, ensuring features like scheduled playback or time-based automations remain accurate.
  • Restart Device: Reboots the device remotely, providing a quick way to recover from connectivity issues or apply configuration changes without physical interaction.

Actions

The WiiM integration makes various custom actions available in addition to the standard media player actions.

Removing the integration

This integration follows the standard integration removal process; no extra steps are required.

To remove an integration instance from Home Assistant

  1. Go to Settings > Devices & services and select the integration card.
  2. From the list of devices, select the integration instance you want to remove.
  3. Next to the entry, select the three dots menu. Then, select Delete.