WiiM Integration Setup

WiiM streamers (such as the WiiM Mini, Pro, Pro Plus, Amp, and Ultra) are LinkPlay-based devices and connect to Home Assistant through the built-in LinkPlay integration. The connection is local and needs no account credentials.

Before You Start

Confirm the following before you begin:

1. The WiiM device is set up in the WiiM Home app and playing correctly.
2. The device is on the same network as Home Assistant.
3. The device has a static IP address or DHCP reservation so it does not change address.

Step 1: Add the LinkPlay Integration

1. In Home Assistant, go to Settings > Devices & Services.
2. WiiM devices are usually discovered automatically. If the device appears under Discovered, select it and confirm.
3. If it is not discovered, select Add Integration, search for LinkPlay, and enter the device’s IP address.
4. Follow the on-screen instructions to complete the setup.
5. Repeat for each WiiM device in the home.

Step 2: Verify the Device

Each WiiM device appears as a media player with playback, volume, and source controls, plus buttons to synchronize the device clock and restart the device.

Step 3: Use Presets and Multiroom

• Presets configured on the device (in the WiiM Home app) can be started from automations with the linkplay.play_preset action.
• Multiple LinkPlay devices can be grouped for multiroom audio using the media_player.join and media_player.unjoin actions.