mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-06-26 12:06:50 +00:00
55 lines
2.0 KiB
Markdown
55 lines
2.0 KiB
Markdown
---
|
|
title: LinkPlay
|
|
description: Connect and control your LinkPlay media players using the LinkPlay integration
|
|
ha_category:
|
|
- Media player
|
|
ha_domain: linkplay
|
|
ha_zeroconf: true
|
|
ha_integration_type: integration
|
|
ha_release: 2024.8
|
|
ha_codeowners:
|
|
- '@Velleman'
|
|
ha_config_flow: true
|
|
ha_platforms:
|
|
- media_player
|
|
- button
|
|
ha_iot_class: Local Polling
|
|
---
|
|
|
|
The LinkPlay {% term integrations %} for Home Assistant allows you to control various media players based on the LinkPlay protocol. The integration supports auto-discovery on your local network through [Zeroconf](/integrations/zeroconf).
|
|
|
|
{% include integrations/config_flow.md %}
|
|
|
|
## Features
|
|
|
|
### Media Player
|
|
|
|
The media player entity offers robust controls and playback features from the media player integration and provides additionally:
|
|
|
|
- **Preset playback**: Play LinkPlay presets configured on the device using the action `linkplay.play_preset`.
|
|
- **Multiroom**: Combine multiple LinkPlay devices in a multiroom. Use the actions `media_player.join` and `media_player.unjoin`.
|
|
|
|
### Buttons
|
|
|
|
The button entities provide some additional LinkPlay features available on the device:
|
|
|
|
- **Time Sync**: Synchronize the device's internal clock with the current time in Home Assistant.
|
|
- **Restart Device**: Reboot the device, allowing for convenient troubleshooting and maintenance.
|
|
|
|
## Actions
|
|
|
|
The LinkPlay integration makes various custom actions available in addition to the [standard media player actions](/integrations/media_player/#actions).
|
|
|
|
### Action `linkplay.play_preset`
|
|
|
|
Play a preset on a LinkPlay media player.
|
|
|
|
{% note %}
|
|
Companion apps, such as 4stream, allow to save music presets (for example, Spotify playlists). This action can be used to start playing these presets.
|
|
{% endnote %}
|
|
|
|
| Data attribute | Optional | Description |
|
|
| ---------------------- | -------- | ----------- |
|
|
| `entity_id` | no | The speakers to target. To target all LinkPlay devices, use `all`.
|
|
| `preset_number` | no | The number of the preset to play.
|