2024-11-27 18:57:16 +01:00

54 lines
1.3 KiB
Markdown

---
title: Emby
description: Instructions on how to integrate Emby into Home Assistant.
ha_category:
- Media player
ha_release: 0.32
ha_iot_class: Local Push
ha_codeowners:
- '@mezz64'
ha_domain: emby
ha_platforms:
- media_player
ha_integration_type: integration
related:
- docs: /docs/configuration/
title: Configuration file
ha_quality_scale: legacy
---
The **Emby** {% term integration %} allows you to control a [Emby](https://emby.media/) multimedia system from Home Assistant.
To add Emby to your installation, add the following to your {% term "`configuration.yaml`" %} file.
{% include integrations/restart_ha_after_config_inclusion.md %}
```yaml
# Example configuration.yaml entry
media_player:
- platform: emby
host: YOUR_IP_ADDRESS
api_key: YOUR_API_KEY
```
{% configuration %}
host:
description: The host name or IP address of the device that is running Emby.
required: false
default: localhost
type: string
api_key:
description: The API key to use to authenticate.
required: true
type: string
ssl:
description: Connect with HTTPS/WSS. Your SSL certificate must be valid.
required: false
default: false
type: boolean
port:
description: The port number of the device that is running Emby.
required: false
default: 8096 (No SSL), 8920 (SSL)
type: integer
{% endconfiguration %}