home-assistant.io/source/_components/media_player.plex.markdown
Dale Higgs 59ab0f11f2 Fix formatting on plex docs
Code blocks appear to need blank lines around them.
2016-07-31 11:39:26 -05:00

2.2 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, featured, ha_release
layout title description date sidebar comments sharing footer logo ha_category featured ha_release
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

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.