home-assistant.io/source/_components/media_player.plex.markdown
2016-10-02 17:12:48 +02:00

2.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_release, ha_iot_class
layout title description date sidebar comments sharing footer logo ha_category featured ha_release ha_iot_class
page Plex Instructions how to integrate Plex into Home Assistant. 2015-10-05 21:21 true false true true plex.png Media Player true 0.7.4 Local Polling

The plex platform allows you to connect a Plex Media Server to Home Assistant. It will allow you to control media playback and see the current playing item. The preferred way to setup the Plex platform is by enabling the the the discovery component and requires GDM to be enabled.

If local authentication is enabled or multiple users are defined, Home Assistant requires an authentication token to be entered in the frontend. Press "CONFIGURE" to do it.

If you don't know your token, see Finding your account token / X-Plex-Token.

If you want to enable the plex platform directly, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
media_player:
  - platform: plex

In case discovery does not work (GDM disabled or non-local plex server), you can create ~/.homeassistant/plex.conf manually.

{"IP_ADDRESS:PORT": {"token": "TOKEN"}}
  • IP_ADDRESS (Required): IP address of the Plex Media Server
  • PORT (Required): Port where Plex is listening. Default is 32400
  • TOKEN (Optional): Only if authentication is required. Set to null (without quotes) otherwise.

At this moment, the Plex platform only supports one Plex Media Server.

It is possible to get errors that look like the following.

ERROR:plexapi:http://192.168.1.10:32400: ('Connection aborted.', BadStatusLine("''",))
INFO:homeassistant.components.media_player.plex:No server found at: http://192.168.1.10:32400

If this occurs, try changing the setting Secure connections in your Plex Media Server to Preferred (instead of Required). The Plex component does not currently support HTTPS.