diff --git a/source/_components/configurator.markdown b/source/_components/configurator.markdown index dc2d75d6e8f..9757234f2f3 100644 --- a/source/_components/configurator.markdown +++ b/source/_components/configurator.markdown @@ -14,8 +14,12 @@ ha_category: Other This component is intended for developers.

-The configurator component allows components to request information from the user. It is currently implemented as the minimum viable product: it supports showing a text, image and button to the user. It will trigger a callback when the button is pressed. +The configurator component allows components to request information from the user. It is currently implemented as the minimum viable product: -The Hue component in [the demo](/demo) is implemented using the configurator. See [the source of the demo component](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/demo.py#L72) for a simple example. +- It supports showing a text, image and button to the user +- Input fields can be defined with a description, and optional type +- It will trigger a callback when the button is pressed + +The Hue component in [the demo](/demo) and Plex are implemented using the configurator. See [the source of the demo component](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/demo.py#L72) for a simple example. See [the source](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/configurator.py#L39) for more details on how to use the configurator component. diff --git a/source/_components/discovery.markdown b/source/_components/discovery.markdown index d56562b2997..0f490ffce1e 100644 --- a/source/_components/discovery.markdown +++ b/source/_components/discovery.markdown @@ -17,6 +17,7 @@ Home Assistant can discover and automatically configure zeroconf/mDNS and uPnP d * Belkin WeMo switches * Philips Hue * Netgear routers + * Plex Media Server It will be able to add Google Chreomcasts and Belkin WeMo switches automatically, for Philips Hue it will require some configuration from the user. diff --git a/source/_components/downloader.markdown b/source/_components/downloader.markdown index 96e303c5235..c8df92231af 100644 --- a/source/_components/downloader.markdown +++ b/source/_components/downloader.markdown @@ -20,6 +20,7 @@ To enable it, add the following lines to your `configuration.yaml`: downloader: download_dir: downloads ``` +If the path is not absolute, it's assumed to be relative to the HASS configuration directory. #### Service `downloader/download_file` diff --git a/source/_components/media_player.plex.markdown b/source/_components/media_player.plex.markdown index 195027d8897..4c98446e10b 100644 --- a/source/_components/media_player.plex.markdown +++ b/source/_components/media_player.plex.markdown @@ -14,20 +14,23 @@ featured: true The Plex platform allows you to connect a [Plex Media Server](https://plex.tv) 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]({{site_root}}/components/discovery.html) and requires GDM to be enabled. -To add Plex to your installation, add the following to your `configuration.yaml` file: +If local authentication is enabled or multiple users are defined, HASS requires an authentication token to be entered in the webinterface. 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`: ```yaml # Example configuration.yaml entry media_player: - platform: plex - name: plex_server - user: YOUR_USERNAME - password: YOUR_PASSWORD + - platform: plex ``` +You may also need to create the file `plex.conf`. +``` +{'IP_ADDRESS:PORT': {'token': 'TOKEN'}} +``` +- **IP_ADDRESS** *Required*: IP address of the Plex Media Server +- **PORT** *required*: Default is 32400 +- **TOKEN** *Optional*: Only is authentication is required. Set to `None` (without quotes) otherwise. -Configuration variables: - -- **name** *Required*: The name of the backend device (Under Plex Media Server > settings > server) -- **user** *Required*: The username for your Pley server. -- **password** *Required*: The password for your Plex server. +At this moment, the Plex platform only supports one Plex Media Server. diff --git a/source/getting-started/devices.markdown b/source/getting-started/devices.markdown index 28f1b664136..dc051adc19d 100644 --- a/source/getting-started/devices.markdown +++ b/source/getting-started/devices.markdown @@ -44,6 +44,8 @@ By default, all of your devices will be visible and have a default icon determin You may find it desireable to customize the look and feel of your front page by altering some of these parameters. This can be done by adding the following config to the `homeassistant:` section. +Entity_pictures, badges, device_tracker pictures, etc can either be a URL or `/local/file.jpg`, which points to directory `www` in the HASS configuration directory. + ```yaml # Example configuration.yaml entry homeassistant: