home-assistant.io/source/_integrations/clementine.markdown
2022-03-30 21:50:39 +02:00

51 lines
1.5 KiB
Markdown

---
title: Clementine Music Player
description: Instructions on how to integrate Clementine Music Player within Home Assistant.
ha_category:
- Media Player
ha_release: 0.39
ha_iot_class: Local Polling
ha_domain: clementine
ha_platforms:
- media_player
ha_integration_type: integration
---
The `clementine` platform allows you to control a [Clementine Music Player](https://www.clementine-player.org).
To add a Clementine Player to your Home Assistant installation, add the following to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
media_player:
- platform: clementine
host: 192.168.0.20
```
{% configuration %}
host:
description: The IP address of the Clementine Player e.g., 192.168.0.20.
required: true
type: string
port:
description: The remote control port.
required: false
default: 5500
type: integer
access_token:
description: The authorization code needed to connect.
required: false
type: integer
name:
description: The name you would like to give to the Clementine player.
required: false
default: Clementine Remote
type: string
{% endconfiguration %}
Remember that Clementine must be configured to accept connections through its network remote control protocol.
You can configure this through Clementine `Tools > Preferences > Network remote control` configuration menu. Enable `Use network remote control` and configure the other options for your use case.
This integration does not implement the `play_media` service so you cannot add tracks to the playlist.