---
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.