diff --git a/source/_integrations/wiim.markdown b/source/_integrations/wiim.markdown new file mode 100644 index 000000000000..6950f78340e8 --- /dev/null +++ b/source/_integrations/wiim.markdown @@ -0,0 +1,50 @@ +--- +title: WiiM +description: Instructions on how to integrate WiiM devices into Home Assistant. +ha_category: + - Media player +ha_domain: wiim +ha_zeroconf: true +ha_integration_type: integration +ha_release: 2025.5 +ha_codeowners: + - '@Linkplay' +ha_config_flow: true +ha_platforms: + - media_player + - button +ha_iot_class: Local Push +--- + +The `wiim` integration for Home Assistant allows you to control different WiiM devices. The integration supports auto-discovery on your local network through [Zeroconf](/integrations/zeroconf), allowing you to seamlessly control your [WiiM](https://www.wiimhome.com) wireless speakers from Home Assistant. + +{% include integrations/config_flow.md %} + +## Features + +### 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](/integrations/media_player/#actions). + +## Removing the integration + +This integration follows the standard integration removal process; no extra steps are required. + +{% include integrations/remove_device_service.md %} \ No newline at end of file