diff --git a/.themes/oscailte b/.themes/oscailte deleted file mode 160000 index 0844f3dd9e1..00000000000 --- a/.themes/oscailte +++ /dev/null @@ -1 +0,0 @@ -Subproject commit 0844f3dd9e1747f1bd6b7b803c04dc3733c36d78 diff --git a/Gemfile b/Gemfile index 38742128962..c9910e1cc53 100644 --- a/Gemfile +++ b/Gemfile @@ -15,6 +15,8 @@ group :development do gem 'rb-fsevent', '~> 0.9' gem 'stringex', '~> 1.4.0' gem 'jekyll-time-to-read' + gem 'execjs' + gem 'therubyracer', :platforms => :ruby end gem 'sinatra', '~> 1.4.2' diff --git a/README.markdown b/README.markdown index 4391085f3c7..6228d5a422a 100644 --- a/README.markdown +++ b/README.markdown @@ -1,46 +1,44 @@ -To test changes to home-assistant.io locally, run `rake preview` and navigate to [http://127.0.0.1:4000](http://127.0.0.1:4000). +# Home Assistant website -Deploying is done using `rake deploy`. +This is the source for the [Home Assistant](https://github.com/balloob/home-assistant) website available at [Home-Assistant.io](https://home-assistant.io). + +## Jekyll project to generate and deploy + +| Command | Action | +|---|---| +| `rake preview` | Preview site on [http://127.0.0.1:4000](http://127.0.0.1:4000) +| `rake generate` | Generate new version of the site +| `rake deploy` | Deploy a new version of the site + +## Setup local environment + +_You need to have Ruby installed._ + +```bash +git clone --recursive https://github.com/balloob/home-assistant.io.git +cd home-assistant.io +bundle +rake preview +``` -## What is Octopress? +### Preparation on CentOS +On CentOS (here 7.1.1503) Ruby is not available by default. Please take the notes here as a little guide for the Ruby installation process. -Octopress is [Jekyll](https://github.com/mojombo/jekyll) blogging at its finest. +```bash +curl -sSL https://rvm.io/mpapis.asc | gpg2 --import - +curl -L get.rvm.io | bash -s stable +source ~/.profile +rvm requirements +rvm install ruby-2.2.2 +rvm use ruby-2.2.2 --default +ruby -v +``` -1. **Octopress sports a clean responsive theme** written in semantic HTML5, focused on readability and friendliness toward mobile devices. -2. **Code blogging is easy and beautiful.** Embed code (with [Solarized](http://ethanschoonover.com/solarized) styling) in your posts from gists, jsFiddle or from your filesystem. -3. **Third party integration is simple** with built-in support for Pinboard, Delicious, GitHub Repositories, Disqus Comments and Google Analytics. -4. **It's easy to use.** A collection of rake tasks simplifies development and makes deploying a cinch. -5. **Ships with great plug-ins** some original and others from the Jekyll community — tested and improved. +The last command will give you something like this `ruby 2.2.2p95 (2015-04-13 revision 50295) [x86_64-linux]`. Then install `bundler`. -**Note**: Octopress requires a minimum Ruby version of `1.9.3-p0`. +```bash +gem install bundler +``` -## Documentation - -Check out [Octopress.org](http://octopress.org/docs) for guides and documentation. -It should all apply to our current stable version (found in the `master` -branch). If this is not the case, [please submit a -fix to our docs repo](https://github.com/octopress/docs). - -## Contributing - -[![Build Status](https://travis-ci.org/imathis/octopress.png?branch=master)](https://travis-ci.org/imathis/octopress) - -We love to see people contributing to Octopress, whether it's a bug report, feature suggestion or a pull request. At the moment, we try to keep the core slick and lean, focusing on basic blogging needs, so some of your suggestions might not find their way into Octopress. For those ideas, we started a [list of 3rd party plug-ins](https://github.com/imathis/octopress/wiki/3rd-party-plugins), where you can link your own Octopress plug-in repositories. For the future, we're thinking about ways to easier add them into our main releases. - - -## License -(The MIT License) - -Copyright © 2009-2013 Brandon Mathis - -Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. - - -#### If you want to be awesome. -- Proudly display the 'Powered by Octopress' credit in the footer. -- Add your site to the Wiki so we can watch the community grow. +Now please follow the instruction above. diff --git a/_deploy b/_deploy index 853a81fe69b..1e8bb05106a 160000 --- a/_deploy +++ b/_deploy @@ -1 +1 @@ -Subproject commit 853a81fe69bcc1acff5492e200a6ab9944b86af2 +Subproject commit 1e8bb05106a8f8e67f1d5d2f58f589b2cf0fd6cc diff --git a/sass/custom/_paulus.scss b/sass/custom/_paulus.scss index 68a093af9cb..aa054ce18ae 100644 --- a/sass/custom/_paulus.scss +++ b/sass/custom/_paulus.scss @@ -189,5 +189,78 @@ p.note { } } +.prep-instructions-container { + #generic-prep, #fedora-prep, #centos-prep, .prep-instructions { + display: none; + } + label.menu-selector { + display: inline-block; + text-align: center; + padding: 10px; + white-space: nowrap; + border-bottom: 2px solid $grayLight; + transition: border-bottom-color .5s; + } + + label.menu-selector + label.menu-selector { + margin-left: 10px; + } + + #generic-prep:checked ~ .menu-selector.generic, + #fedora-prep:checked ~ .menu-selector.fedora, + #centos-prep:checked ~ .menu-selector.centos + { + border-bottom-color: $blue; + } + + #generic-prep:checked ~ .prep-instructions.generic, + #fedora-prep:checked ~ .prep-instructions.fedora, + #centos-prep:checked ~ .prep-instructions.centos + { + display: block; + } + + .prep-instructions { + margin-top: 20px; + } +} + +.post-instructions-container { + #generic-post, #fedora-post, #debian-post, .post-instructions { + display: none; + } + + label.menu-selector { + display: inline-block; + text-align: center; + padding: 10px; + white-space: nowrap; + border-bottom: 2px solid $grayLight; + transition: border-bottom-color .5s; + } + + label.menu-selector + label.menu-selector { + margin-left: 10px; + } + + #generic-post:checked ~ .menu-selector.generic-post, + #fedora-post:checked ~ .menu-selector.fedora-post, + #debian-post:checked ~ .menu-selector.debian-post + { + border-bottom-color: $blue; + } + + #generic-post:checked ~ .post-instructions.generic-post, + #fedora-post:checked ~ .post-instructions.fedora-post, + #debian-post:checked ~ .post-instructions.debian-post + { + display: block; + } + + .post-instructions { + margin-top: 20px; + } + +} diff --git a/source/_includes/custom/grid_item_left.html b/source/_includes/custom/grid_item_left.html index e7dd86ccb88..17aa0ac0531 100644 --- a/source/_includes/custom/grid_item_left.html +++ b/source/_includes/custom/grid_item_left.html @@ -4,19 +4,17 @@
- + + - - -

Browse all »

diff --git a/source/_includes/custom/navigation.html b/source/_includes/custom/navigation.html index 5e0ca259357..06d049a284e 100644 --- a/source/_includes/custom/navigation.html +++ b/source/_includes/custom/navigation.html @@ -24,5 +24,5 @@
  • Blog
    • -
  • Need help?
    • +
  • Need help?
    • diff --git a/source/_posts/2015-07-11-ip-cameras-arduino-kodi-efergy-support.markdown b/source/_posts/2015-07-11-ip-cameras-arduino-kodi-efergy-support.markdown new file mode 100644 index 00000000000..6ebdb75ffd0 --- /dev/null +++ b/source/_posts/2015-07-11-ip-cameras-arduino-kodi-efergy-support.markdown @@ -0,0 +1,129 @@ +--- +layout: post +title: "IP Cameras, Arduinos, Kodi and Efergy Energy Monitors now supported" +description: "New support for IP Cameras, Arduinos, Kodi and Efergy monitors" +date: 2015-07-11 01:37 -0700 +date_formatted: "July 11, 2015" +comments: true +categories: release-notes +--- + +Another month has passed and some great new features have landed in Home Assistant. This month release has been made possible by [balloob](https://github.com/balloob), [ettisan](https://github.com/ettisan), [fabaff](https://github.com/fabaff), [gyran](https://github.com/gyran), [jamespcole](https://github.com/jamespcole), [michaelarnauts](https://github.com/michaelarnauts), [miniconfig](https://github.com/miniconfig) and [rmkraus](https://github.com/rmkraus). + +This release includes some architectural changes by me. The first is that the frontend is now based on a [NuclearJS](http://optimizely.github.io/nuclear-js/) JavaScript backend. This has greatly helped to organize and optimize the frontend code. Another change is that Home Assistant will now install dependencies on-demand instead of installing dependencies for all supported devices. + +__IP Camera Support__
    +James has worked very hard to add support for IP cameras to Home Assistant which is included in this release. The initial release focusses on providing generic IP camera support. This means that any webcam that can exposes a JPEG image via a url can be integrated. + +Home Assistant will route the requests to your camera via the server allowing you to expose IP camera's inside your network via the Home Assistant app. + +```yaml +# Example configuration.yaml entry +camera: + platform: generic + name: my sample camera + username: MY_USERNAME + password: MY_PASSWORD + still_image_url: http://194.218.96.92/jpg/image.jpg +``` + +

    +To update to the latest version, run scripts/update. Please report any issues on GitHub. +

    + + + +__Arduino__
    + +Fabian has contributed support for interfacing with Arduinos. This makes it possible to connect your Arduino via USB and expose pins as sensor data and write to pins via switches. Have a look at [the docs](/components/arduino.html) for an extensive guide to get started. + +```yaml +# Example configuration.yaml entry +switch: + platform: arduino + pins: + 11: + name: Fan Office + type: digital + 12: + name: Light Desk + type: digital + +sensor: + platform: arduino + pins: + 1: + name: Door switch + type: analog + 0: + name: Brightness + type: analog +``` + +__Kodi (XBMC)__
    + +Ettisan has contributed a Kodi (XBMC) platform for the media player component. This allows you to track all the media that you are playing and allow you to control it. + +``` +# Example configuration.yaml entry +media_player: + platform: kodi + name: Kodi + url: http://192.168.0.123/jsonrpc + user: kodi + password: my_secure_password +``` + +__TP-Link__
    + +Michael has added TP-Link support to the device tracker. This allows you to now detect presence if you have a TP-Link router. + +```yaml +# Example configuration.yaml entry +device_tracker: + platform: tplink + host: YOUR_ROUTER_IP + username: YOUR_ADMIN_USERNAME + password: YOUR_ADMIN_PASSWORD +``` + +__Efergy energy monitor__
    + +Miniconfig has contributed support for the [Efergy energy meters](https://efergy.com). To get an app token, log in to your efergy account, go to the Settings page, click on App tokens, and click "Add token". + +```yaml +# Example configuration.yaml entry +sensor: + platform: efergy + app_token: APP_TOKEN + utc_offset: UTC_OFFSET + monitored_variables: + - type: instant_readings + - type: budget + - type: cost + period: day + currency: $ +``` + +__Forecast.io__
    +Fabian has added support for [Forecast.io](https://forecast.io/) to get weather forecasts for Home Assistant. You need an API key which is free but requires a [registration](https://developer.forecast.io/register). To add Forecast.io to your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + platform: forecast + api_key: YOUR_APP_KEY + monitored_conditions: + - summary + - precip_type + - precip_intensity + - temperature + - dew_point + - wind_speed + - wind_bearing + - cloud_cover + - humidity + - pressure + - visibility + - ozone +``` diff --git a/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown b/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown new file mode 100644 index 00000000000..8845471af0f --- /dev/null +++ b/source/_posts/2015-08-09-mqtt-raspberry-pi-squeezebox-asuswrt-support.markdown @@ -0,0 +1,120 @@ +--- +layout: post +title: "MQTT, Rasperry PI, Logitech Squeezebox and ASUSWRT routers now supported" +description: "New support for MQTT, Rasperry PI GPIO, Logitech Squeezebox and ASUSWRT routers" +date: 2015-08-09 18:01 -0700 +date_formatted: "August 9, 2015" +comments: true +categories: release-notes +--- + +It's time for the August release and there is some serious good stuff this time. The core of Home Assistant has gone some serious clean up and a bump in test coverage thanks to [@balloob](https://github.com/balloob). If you're a developer, make sure you read up on [the deprecation notices](https://github.com/balloob/home-assistant/pull/251). [@fabaff](https://github.com/fabaff) did another great round of documentating all the various components. + +__MQTT Support__
    + +The big new addition in this release is the support for the MQTT protocol by [@fabaff](https://github.com/fabaff) with some help from [@balloob](https://github.com/balloob). It will now be possible to integrate any IoT device that talks via MQTT. For the initial release we support connecting Home Assistant to a broker (no TLS yet). Components can now subscribe and publish to MQTT topics ([see the example][mqtt-example]) and also support for the automation component [has been added][mqtt-automation]. For more information, see [the MQTT component page][mqtt-component]. + +[mqtt-example]: https://github.com/balloob/home-assistant/blob/dev/config/custom_components/mqtt_example.py +[mqtt-automation]: /components/automation.html#mqtt-based-automation +[mqtt-component]: /components/mqtt.html + +```yaml +# Example configuration.yaml entry +mqtt: + broker: IP_ADDRESS_BROKER + # All the other options are optional: + port: 1883 + keepalive: 60 + qos: 0 + username: your_username + password: your_secret_password +``` + + + +__Raspberry PI GPIO Support__
    + +[@gbarba](https://github.com/gbarba) has contributed support to use the general purpose input and output pins on a Raspberry PI as switches inside Home Assistant. + +``` +# Example configuration.yaml entry +switch: + platform: rpi_gpio + ports: + 11: Fan Office + 12: Light Desk +``` + +__ASUSWRT based routers__
    + +[@persandstrom](https://github.com/persandstrom) has contributed support to do prescence detection using ASUSWRT based routers. + +```yaml +# Example configuration.yaml entry +device_tracker: + platform: asuswrt + host: YOUR_ROUTER_IP + username: YOUR_ADMIN_USERNAME + password: YOUR_ADMIN_PASSWORD +``` + +__Logitech Squeezebox media player support__
    + +[@persandstrom](https://github.com/persandstrom) also contributed support for the Logitech Squeezebox media player. This allows you to control your Logitech Squeezebox from Home Assistant. + +``` +# Example configuration.yaml entry +media_player: + platform: squeezebox + host: 192.168.1.21 + port: 9090 + username: user + password: password +``` + +__Slack notification support__
    + +[@jamespcole](https://github.com/jamespcole) has contributed a Slack platform for the notification platform. This allows you to deliver messages to any channel. + +```yaml +# Example configuration.yaml entry +notify: + platform: slack + api_key: ABCDEFGHJKLMNOPQRSTUVXYZ + default_channel: '#general' +``` + +__Edimax Smart Switches support__
    + +[@rkabadi](https://github.com/rkabadi) has contributed support for integrating Edimax Smart Switches into Home Assistant. + +``` +# Example configuration.yaml entry +switch: + platform: edimax + host: 192.168.1.32 + username: YOUR_USERNAME + password: YOUR_PASSWORD + name: Edimax Smart Plug +``` + +__RFXtrx sensor support__
    +[@danielhiversen](https://github.com/danielhiversen) has contributed support for RFXtrx sensors. It supports sensors that communicate in the frequency range of 433.92 MHz. + +```yaml +# Example configuration.yaml entry +sensor: + - platform: rfxtrx + device: PATH_TO_DEVICE +``` + +The path to your device, e.g. `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0` + +__TEMPer temperature sensor support__
    +Support for Temper temperature sensors has been contributed by [@rkabadi](https://github.com/rkabadi). + +``` +# Example configuration.yaml entry +sensor: + platform: temper +``` diff --git a/source/_posts/2015-08-17-verisure-and-modern-tp-link-router-support.markdown b/source/_posts/2015-08-17-verisure-and-modern-tp-link-router-support.markdown new file mode 100644 index 00000000000..983d48d3370 --- /dev/null +++ b/source/_posts/2015-08-17-verisure-and-modern-tp-link-router-support.markdown @@ -0,0 +1,33 @@ +--- +layout: post +title: "Verisure devices and modern TP-Link routers now supported" +description: "New support for Verisure switches, sensors and hygrometers and modern TP-Link routers" +date: 2015-08-17 20:00 -0700 +date_formatted: "August 17, 2015" +comments: true +categories: release-notes +--- + +A minor bug fix release to fix some issues that have come up since the last release. Please upgrade as soon as possible by running `git pull` from the Home Assistant directory. + +This release is a major milestone in our test coverage as we've crossed into the 80s! It has to be noted that this covers mainly the core and automation components. Platforms that communicate with IoT devices have been excluded. + +As we didn't want to just push out bug fixes, this release includes a few additions: + + - Support for modern TP-Link routers like the ArcherC9 line has been contributed by [@chrisvis](https://github.com/chrisvis). + - Improved support for MQTT topic subscriptions has been contributed by [@qrtn](https://github.com/qrtn) + +__Verisure Support__
    + +Home Assistant support to integrate your [Verisure](https://www.verisure.com/) alarms, hygrometers, sensors and thermometers has been contributed by [@persandstrom](https://github.com/persandstrom). + +```yaml +# Example configuration.yaml entry +verisure: + username: user@example.com + password: password + alarm: 1 + hygrometers: 0 + smartplugs: 1 + thermometers: 0 +``` diff --git a/source/components/automation.markdown b/source/components/automation.markdown index 74ac93b01bb..306d9fa57a6 100644 --- a/source/components/automation.markdown +++ b/source/components/automation.markdown @@ -29,10 +29,10 @@ automation: service_data: {"message":"The sun has set"} ``` -## Setting up triggers +## {% linkable_title Setting up triggers %} -#### Time-based automation -This allows you to trigger actions whenever the time matches your filter. You can setup filters to match on hours, minutes and seconds. Any filter that you omit will match all values. +#### {% linkable_title Time-based automation %} +This allows you to trigger actions whenever the time matches your filter. You can setup filters to match on hours, minutes and seconds. Any filter that you omit will match all values. Here are some example values: @@ -49,7 +49,7 @@ Here are some example values: time_seconds: 0 ``` -#### State-based automation +#### {% linkable_title State-based automation %} This allows you to trigger actions based on state changes of any entity within Home Assistant. You can omit the `state_from` and `state_to` to match all. ``` @@ -76,7 +76,21 @@ This allows you to trigger actions based on state changes of any entity within H Use quotes around your values for state_from and state_to to avoid the YAML parser interpreting some values as booleans.

    -## Setting up the action +#### {% linkable_title MQTT-based automation %} +This allows you to trigger actions based on messages on an MQTT topic. You can specify an optional payload to match as well. + +``` + # Match any changes to bathroom light + platform: mqtt + mqtt_topic: home/bathroom/light + + # Match only if bathroom light is turned on + platform: mqtt + mqtt_topic: home/bathroom/light + mqtt_payload: 'on' +``` + +## {% linkable_title Setting up the action %} Currently the only supported action is calling a service. Services are what devices expose to be controlled, so this will allow us to control anything that Home Assistant can control. @@ -95,7 +109,7 @@ Currently the only supported action is calling a service. Services are what devi service_data: {"message":"YAY"} ``` -## Putting it all together +## {% linkable_title Putting it all together %} For every combination of a trigger and an action we will have to combine the configuration lines and add it to an `automation` component entry in `configuration.yaml`. You can add an optional `alias` key to the configuration to make the logs more understandable. To setup multiple entries, append 2, 3 etc to the section name. An example of a `configuration.yaml` file: ``` diff --git a/source/components/camera.generic.markdown b/source/components/camera.generic.markdown new file mode 100644 index 00000000000..b0d54041383 --- /dev/null +++ b/source/components/camera.generic.markdown @@ -0,0 +1,25 @@ +--- +layout: page +title: "Generic IP Camera" +description: "Instructions how to integrate IP cameras within Home Assistant." +date: 2015-07-11 0:36 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +This component allows you to integrate any IP camera into Home Assistant. It supports fetching images from a url with optional HTTP authentication. + +Home Assistant will serve the images via its server, making it possible to view your IP camera's while outside of your network. + +```yaml +# Example configuration.yaml entry +camera: + platform: generic + name: my sample camera + username: MY_USERNAME + password: MY_PASSWORD + still_image_url: http://194.218.96.92/jpg/image.jpg +``` diff --git a/source/components/device_tracker.asuswrt.markdown b/source/components/device_tracker.asuswrt.markdown new file mode 100644 index 00000000000..362a30a3a3e --- /dev/null +++ b/source/components/device_tracker.asuswrt.markdown @@ -0,0 +1,28 @@ +--- +layout: page +title: "ASUSWRT support" +description: "Instructions how to integrate ASUSWRT based routers into Home Assistant." +date: 2015-08-06 19:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +This platform offers presence detection by looking at connected devices to a [ASUSWRT](http://event.asus.com/2013/nw/ASUSWRT/) based router. + +To use an ASUSWRT router in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +device_tracker: + platform: asuswrt + host: YOUR_ROUTER_IP + username: YOUR_ADMIN_USERNAME + password: YOUR_ADMIN_PASSWORD +``` + +This device tracker needs telnet to be enabled on the router. + +See the [device tracker component page](/components/device_tracker.html) for instructions how to configure the people to be tracked. diff --git a/source/components/device_tracker.ddwrt.markdown b/source/components/device_tracker.ddwrt.markdown index c7b8b00a47e..4435eda1b27 100644 --- a/source/components/device_tracker.ddwrt.markdown +++ b/source/components/device_tracker.ddwrt.markdown @@ -12,6 +12,8 @@ footer: true This platform offers presence detection by looking at connected devices to a [DD-WRT](http://www.dd-wrt.com/site/index) based router. +To use a DD-WRRT router in your installation, add the following to your `configuration.yaml` file: + ```yaml # Example configuration.yaml entry device_tracker: diff --git a/source/components/device_tracker.tplink.markdown b/source/components/device_tracker.tplink.markdown index 159e0fb9c95..d10750af4ba 100644 --- a/source/components/device_tracker.tplink.markdown +++ b/source/components/device_tracker.tplink.markdown @@ -10,7 +10,7 @@ footer: true --- -This platform allows you to detect presence by looking at connected devices to a [TP-Link](https://www.tp-link.com) device. +This platform allows you to detect presence by looking at connected devices to a [TP-Link](https://www.tp-link.com) device. This includes the ArcherC9 line. ```yaml # Example configuration.yaml entry diff --git a/source/components/index.markdown b/source/components/index.markdown index 198109b3696..6ee4d4426eb 100644 --- a/source/components/index.markdown +++ b/source/components/index.markdown @@ -64,6 +64,18 @@ Entities are things that you want to observe within Home Assistant. Support for Integrate MySensors sensors. + + + TEMPer sensors + Integrate TEMPer sensors to get the current temperature. + + + + + ASUSWRT routers + Offers presence detection by looking at connected devices. + + DD-WRT routers @@ -127,6 +139,12 @@ Entities are things that you want to observe within Home Assistant. Support for Track what is being played and control playback. + + + Squeezebox + Track what is being played and control playback. + + Command line Switch @@ -145,6 +163,18 @@ Entities are things that you want to observe within Home Assistant. Support for Control the motion detection setting on your Hikvision camera. + + + Edimax switches + Control the state of your Edimax switches. + + + + + Raspberry PI GPIO + Control the GPIO of a Raspberry Pi. + + Insteon Devices @@ -163,6 +193,24 @@ Entities are things that you want to observe within Home Assistant. Support for Controls your Arduino's digital pins and read from the analog pins. + + + Efergy Engage hubs + Monitors home energy use as measured by an Efergy engage hub. + + + + + RFXtrx sensors + Monitors values from RFXtrx sensors. + + + + + Generic IP cameras + Integrate any IP camera or image url into a camera feed. + +

    @@ -180,13 +228,15 @@ the manufacturers of these devices. Home Assistant integrates with a variety of third party Home Automation hubs and networks. It allows you to control the connected switches, lights and sensors via Home Assistant. Click on the following logos for setup instructions: -[](/components/zwave.html) -[](/components/tellstick.html) -[](/components/vera.html) -[](/components/wink.html) -[](/components/isy994.html) -[](/components/modbus.html) -[](/components/arduino.html) +[Zwave](/components/zwave.html) +[Tellstick](/components/tellstick.html) +[Vera](/components/vera.html) +[Wink](/components/wink.html) +[ISY994](/components/isy994.html) + +[Modbus](/components/modbus.html) +[Arduino](/components/arduino.html) +[Verisure](/components/verisure.html)

    Support for these devices is provided by the Home Assistant community and not @@ -250,6 +300,12 @@ the manufacturers of these devices. Allow sending messages using PushOver. + + + Slack + Allow sending messages over Slack. + + E-Mail @@ -315,6 +371,12 @@ the manufacturers of these devices. Time & Date Displays the time and the date. + + + + MQTT + Allow sending and recieving MQTT messages. +

    diff --git a/source/components/media_player.squeezebox.markdown b/source/components/media_player.squeezebox.markdown new file mode 100644 index 00000000000..af69465f39e --- /dev/null +++ b/source/components/media_player.squeezebox.markdown @@ -0,0 +1,26 @@ +--- +layout: page +title: "Logitech Squeezebox support" +description: "Instructions how to integrate a Logitech Squeezebox into Home Assistant." +date: 2015-08-09 11:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +The squeezebox platform allows you to control a [Logitech Squeezebox](https://en.wikipedia.org/wiki/Squeezebox_%28network_music_player%29) multimedia system from Home Assistant. + +To add your Squeezebox to your installation, add the following to your `configuration.yaml` file: + +``` +# Example configuration.yaml entry +media_player: + platform: squeezebox + host: 192.168.1.21 + port: 9090 + username: user + password: password +``` + diff --git a/source/components/modbus.markdown b/source/components/modbus.markdown index a0dcd86b762..73f3abf6313 100644 --- a/source/components/modbus.markdown +++ b/source/components/modbus.markdown @@ -38,6 +38,9 @@ sensor: name: My boolean sensor 2: name: My other boolean sensor + coils: + 0: + name: My coil switch switch: platform: modbus diff --git a/source/components/mqtt.markdown b/source/components/mqtt.markdown new file mode 100644 index 00000000000..97962444823 --- /dev/null +++ b/source/components/mqtt.markdown @@ -0,0 +1,65 @@ +--- +layout: page +title: "MQTT" +description: "Instructions how to setup MQTT within Home Assistant." +date: 2015-08-07 18:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + +MQTT (aka MQ Telemetry Transport) is a machine-to-machine or "Internet of Things" connectivity protocol on top of TCP/IP. It allows extremely lightweight publish/subscribe messaging transport. + +The MQTT component needs an MQTT broker like [Mosquitto](http://mosquitto.org/) or [Mosca](http://www.mosca.io/). The Eclipse Foundation is running a public MQTT broker at [iot.eclipse.org](iot.eclipse.org) or the Mosquitto Project under [test.mosquitto.org](http://test.mosquitto.org). If you prefer to use a public, keep in mind to adjust the topic and that your messages may be publicly accessible. + +To integrate MQTT into Home Assistant, add the following section to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +mqtt: + broker: IP_ADDRESS_BROKER + # All the other options are optional: + port: 1883 + keepalive: 60 + qos: 0 + username: your_username + password: your_secret_password +``` + +

    +The MQTT component has no TLS support at the moment. This means that only plain-text communication is possible. +

    + +## Building on top of MQTT + +There are two ways to integrate MQTT into your process. One is by using the [MQTT-automation rule](/components/automation.html#mqtt-based-automation). The other one is by integrating it into a component. See the [MQTT example component](https://github.com/balloob/home-assistant/blob/dev/config/custom_components/mqtt_example.py) how to do this. + +## Testing + +For debugging purposes `mosquitto` is shipping commandline tools to send and recieve MQTT messages. For sending test messages to a broker running on localhost: + +```bash +mosquitto_pub -h 127.0.0.1 -t home-assistant/switch/1/on -m "Switch is ON" +``` + +Another way to send MQTT messages by hand is to use the "Developer Tools" in the Frontend. Choose "Call Service" and then `mqtt/mqtt_send` under "Available Services". Enter something similar to the example below into the "Service Data" field. + +```json +{ + "topic":"home-assistant/switch/1/on", + "payload":"Switch is ON" +} +``` + +The message should appear on the bus: + +```bash +... [homeassistant] Bus:Handling +``` + +For reading all messages sent on the topic `home-assistant` to a broker running on localhost: + +```bash +mosquitto_sub -h 127.0.0.1 -v -t "home-assistant/#" +``` diff --git a/source/components/notify.slack.markdown b/source/components/notify.slack.markdown new file mode 100644 index 00000000000..27dac99a978 --- /dev/null +++ b/source/components/notify.slack.markdown @@ -0,0 +1,26 @@ +--- +layout: page +title: "Slack notification support" +description: "Instructions how to add Slack notifications to Home Assistant." +date: 2015-08-06 18:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +The slack platform allows you to deliver notifications from Home Assistant to [Slack](https://slack.com/). + +You need to obtain the [Slack API token](https://api.slack.com/web?sudo=1) to be able to send notifications. + +To enable the slack notification in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +notify: + platform: slack + api_key: ABCDEFGHJKLMNOPQRSTUVXYZ + default_channel: '#general' +``` + diff --git a/source/components/sensor.efergy.markdown b/source/components/sensor.efergy.markdown new file mode 100644 index 00000000000..7886ef0e459 --- /dev/null +++ b/source/components/sensor.efergy.markdown @@ -0,0 +1,27 @@ +--- +layout: page +title: "Efergy support" +description: "Instructions how to integrate Efergy devices within Home Assistant." +date: 2015-07-11 0:15 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +Integrate your [Efergy](https://efergy.com) meter information into Home Assistant. To get an app token, log in to your efergy account, go to the Settings page, click on App tokens, and click "Add token". + +```yaml +# Example configuration.yaml entry +sensor: + platform: efergy + app_token: APP_TOKEN + utc_offset: UTC_OFFSET + monitored_variables: + - type: instant_readings + - type: budget + - type: cost + period: day + currency: $ +``` diff --git a/source/components/sensor.rfxtrx.markdown b/source/components/sensor.rfxtrx.markdown new file mode 100644 index 00000000000..c1309abcded --- /dev/null +++ b/source/components/sensor.rfxtrx.markdown @@ -0,0 +1,23 @@ +--- +layout: page +title: "RFXtrx sensors support" +description: "Instructions how to integrate RFXtrx sensors into Home Assistant." +date: 2015-08-06 17:15 +sidebar: false +comments: false +sharing: true +footer: true +--- +The rfxtrx platform support sensors that communicate in the frequency range of 433.92 MHz. + +To enable the RFXtrx sensors in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: rfxtrx + device: PATH_TO_DEVICE +``` + +The path to your device, e.g. `/dev/serial/by-id/usb-RFXCOM_RFXtrx433_A1Y0NJGR-if00-port0` + diff --git a/source/components/sensor.temper.markdown b/source/components/sensor.temper.markdown new file mode 100644 index 00000000000..352584ca224 --- /dev/null +++ b/source/components/sensor.temper.markdown @@ -0,0 +1,20 @@ +--- +layout: page +title: "TEMPer sensors support" +description: "Instructions how to integrate TEMPer sensors into Home Assistant." +date: 2015-08-06 19:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + +This temper sensor platform allows you to get the current temperature from a TEMPer device. + +To use your TEMPer sensor in your installation, add the following to your `configuration.yaml` file: + +``` +# Example configuration.yaml entry +sensor: + platform: temper +``` diff --git a/source/components/switch.command_switch.markdown b/source/components/switch.command_switch.markdown index 39905e8a0ba..407fdee7372 100644 --- a/source/components/switch.command_switch.markdown +++ b/source/components/switch.command_switch.markdown @@ -19,7 +19,7 @@ To enable it, add the following lines to your `configuration.yaml`: switch: platform: command_switch switches: - - kitchen_light: - oncmd: switch_command on kitchen - offcmd: switch_command off kitchen + kitchen_light: + oncmd: switch_command on kitchen + offcmd: switch_command off kitchen ``` diff --git a/source/components/switch.edimax.markdown b/source/components/switch.edimax.markdown new file mode 100644 index 00000000000..cbe99fafe09 --- /dev/null +++ b/source/components/switch.edimax.markdown @@ -0,0 +1,25 @@ +--- +layout: page +title: "Edimax switches support" +description: "Instructions how to integrate Edimax switches into Home Assistant." +date: 2015-06-10 22:54 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +This edimax switch platform allows you to control the state of your [Edimax](http://www.edimax.com/edimax/merchandise/merchandise_list/data/edimax/global/home_automation_smart_plug/) switches. + +To use your Edimax switch in your installation, add the following to your `configuration.yaml` file: + +``` +# Example configuration.yaml entry +switch: + platform: edimax + host: 192.168.1.32 + username: YOUR_USERNAME + password: YOUR_PASSWORD + name: Edimax Smart Plug +``` diff --git a/source/components/switch.rpi_gpio.markdown b/source/components/switch.rpi_gpio.markdown new file mode 100644 index 00000000000..76a5bbbde98 --- /dev/null +++ b/source/components/switch.rpi_gpio.markdown @@ -0,0 +1,26 @@ +--- +layout: page +title: "Raspberry PI GPIO support" +description: "Instructions how to integrate the GPIO of a Raspberry PI into Home Assistant." +date: 2015-08-07 14:00 +sidebar: false +comments: false +sharing: true +footer: true +--- + + +The rpi_gpio switch platform allows you to control the GPIOs of your [Raspberry Pi](https://www.raspberrypi.org/). + +To use your Raspberry Pi's GPIO in your installation, add the following to your `configuration.yaml` file: + +``` +# Example configuration.yaml entry +switch: + platform: rpi_gpio + ports: + 11: Fan Office + 12: Light Desk +``` + +For more details about the GPIO layout, visit the Wikipedia [article](https://en.wikipedia.org/wiki/Raspberry_Pi#GPIO_connector) about the Raspberry Pi. diff --git a/source/components/switch.wemo.markdown b/source/components/switch.wemo.markdown index 13e1c27b0de..1d680f2f54d 100644 --- a/source/components/switch.wemo.markdown +++ b/source/components/switch.wemo.markdown @@ -10,11 +10,12 @@ footer: true --- -The wemo platform allows you to control your [Belkin WeMo](http://www.belkin.com/us/p/P-F7C027/) switches from within Home Assistant. +The wemo platform allows you to control your [Belkin WeMo](http://www.belkin.com/us/p/P-F7C027/) switches from within Home Assistant. To add Wemo switches to your installation, add the following to your `configuration.yaml` file: ```yaml +# Example configuration.yaml entry switch: - platform: wemo + - platform: wemo ``` diff --git a/source/components/verisure.markdown b/source/components/verisure.markdown new file mode 100644 index 00000000000..e8962b91040 --- /dev/null +++ b/source/components/verisure.markdown @@ -0,0 +1,33 @@ +--- +layout: page +title: "Verisure" +description: "Instructions how to setup Verisure devices within Home Assistant." +date: 2015-08-17 20:28 +sidebar: false +comments: false +sharing: true +footer: true +--- + + + +Home Assistant has support to integrate your [Verisure](https://www.verisure.com/) devices. + +We support: + + * Smartplugs + * Reading from thermometers and hygrometers integrated in various devices + * Reading alarm status + +Username and password are required. Other variables are optional and allow you to disable certain devices. + +```yaml +# Example configuration.yaml entry +verisure: + username: user@example.com + password: password + alarm: 1 + hygrometers: 0 + smartplugs: 1 + thermometers: 0 +``` diff --git a/source/demo/frontend.html b/source/demo/frontend.html index b1c6d302076..ae077e87c5f 100644 --- a/source/demo/frontend.html +++ b/source/demo/frontend.html @@ -1,5811 +1,6 @@ - - - - - - - - - - - - - - - - - - - + @-webkit-keyframes ha-spin { + 0% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); + } + 100% { + -webkit-transform: rotate(359deg); + transform: rotate(359deg); + } + } + @keyframes ha-spin { + 0% { + -webkit-transform: rotate(0deg); + transform: rotate(0deg); + } + 100% { + -webkit-transform: rotate(359deg); + transform: rotate(359deg); + } + } - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + } \ No newline at end of file diff --git a/source/demo/manifest.json b/source/demo/manifest.json index 69143ce5179..4454a923df9 100644 --- a/source/demo/manifest.json +++ b/source/demo/manifest.json @@ -1,7 +1,7 @@ { "name": "Home Assistant", "short_name": "Assistant", - "start_url": "/", + "start_url": "/demo/", "display": "standalone", "icons": [ { diff --git a/source/demo/webcomponents-lite.min.js b/source/demo/webcomponents-lite.min.js index abb6ff6700e..84acb55dd45 100644 --- a/source/demo/webcomponents-lite.min.js +++ b/source/demo/webcomponents-lite.min.js @@ -7,7 +7,7 @@ * Code distributed by Google as part of the polymer project is also * subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt */ -// @version 0.7.5 -window.WebComponents=window.WebComponents||{},function(e){var t=e.flags||{},n="webcomponents-lite.js",r=document.querySelector('script[src*="'+n+'"]');if(!t.noOpts){if(location.search.slice(1).split("&").forEach(function(e){var n,r=e.split("=");r[0]&&(n=r[0].match(/wc-(.+)/))&&(t[n[1]]=r[1]||!0)}),r)for(var o,i=0;o=r.attributes[i];i++)"src"!==o.name&&(t[o.name]=o.value||!0);if(t.log){var a=t.log.split(",");t.log={},a.forEach(function(e){t.log[e]=!0})}else t.log={}}t.shadow=t.shadow||t.shadowdom||t.polyfill,t.shadow="native"===t.shadow?!1:t.shadow||!HTMLElement.prototype.createShadowRoot,t.register&&(window.CustomElements=window.CustomElements||{flags:{}},window.CustomElements.flags.register=t.register),e.flags=t}(window.WebComponents),function(e){"use strict";function t(e){return void 0!==h[e]}function n(){s.call(this),this._isInvalid=!0}function r(e){return""==e&&n.call(this),e.toLowerCase()}function o(e){var t=e.charCodeAt(0);return t>32&&127>t&&-1==[34,35,60,62,63,96].indexOf(t)?e:encodeURIComponent(e)}function i(e){var t=e.charCodeAt(0);return t>32&&127>t&&-1==[34,35,60,62,96].indexOf(t)?e:encodeURIComponent(e)}function a(e,a,s){function c(e){b.push(e)}var d=a||"scheme start",u=0,l="",_=!1,w=!1,b=[];e:for(;(e[u-1]!=f||0==u)&&!this._isInvalid;){var g=e[u];switch(d){case"scheme start":if(!g||!m.test(g)){if(a){c("Invalid scheme.");break e}l="",d="no scheme";continue}l+=g.toLowerCase(),d="scheme";break;case"scheme":if(g&&v.test(g))l+=g.toLowerCase();else{if(":"!=g){if(a){if(f==g)break e;c("Code point not allowed in scheme: "+g);break e}l="",u=0,d="no scheme";continue}if(this._scheme=l,l="",a)break e;t(this._scheme)&&(this._isRelative=!0),d="file"==this._scheme?"relative":this._isRelative&&s&&s._scheme==this._scheme?"relative or authority":this._isRelative?"authority first slash":"scheme data"}break;case"scheme data":"?"==g?(this._query="?",d="query"):"#"==g?(this._fragment="#",d="fragment"):f!=g&&" "!=g&&"\n"!=g&&"\r"!=g&&(this._schemeData+=o(g));break;case"no scheme":if(s&&t(s._scheme)){d="relative";continue}c("Missing scheme."),n.call(this);break;case"relative or authority":if("/"!=g||"/"!=e[u+1]){c("Expected /, got: "+g),d="relative";continue}d="authority ignore slashes";break;case"relative":if(this._isRelative=!0,"file"!=this._scheme&&(this._scheme=s._scheme),f==g){this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query=s._query,this._username=s._username,this._password=s._password;break e}if("/"==g||"\\"==g)"\\"==g&&c("\\ is an invalid code point."),d="relative slash";else if("?"==g)this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query="?",this._username=s._username,this._password=s._password,d="query";else{if("#"!=g){var y=e[u+1],E=e[u+2];("file"!=this._scheme||!m.test(g)||":"!=y&&"|"!=y||f!=E&&"/"!=E&&"\\"!=E&&"?"!=E&&"#"!=E)&&(this._host=s._host,this._port=s._port,this._username=s._username,this._password=s._password,this._path=s._path.slice(),this._path.pop()),d="relative path";continue}this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query=s._query,this._fragment="#",this._username=s._username,this._password=s._password,d="fragment"}break;case"relative slash":if("/"!=g&&"\\"!=g){"file"!=this._scheme&&(this._host=s._host,this._port=s._port,this._username=s._username,this._password=s._password),d="relative path";continue}"\\"==g&&c("\\ is an invalid code point."),d="file"==this._scheme?"file host":"authority ignore slashes";break;case"authority first slash":if("/"!=g){c("Expected '/', got: "+g),d="authority ignore slashes";continue}d="authority second slash";break;case"authority second slash":if(d="authority ignore slashes","/"!=g){c("Expected '/', got: "+g);continue}break;case"authority ignore slashes":if("/"!=g&&"\\"!=g){d="authority";continue}c("Expected authority, got: "+g);break;case"authority":if("@"==g){_&&(c("@ already seen."),l+="%40"),_=!0;for(var L=0;L>>0)+(t++ +"__")};n.prototype={set:function(t,n){var r=t[this.name];return r&&r[0]===t?r[1]=n:e(t,this.name,{value:[t,n],writable:!0}),this},get:function(e){var t;return(t=e[this.name])&&t[0]===e?t[1]:void 0},"delete":function(e){var t=e[this.name];return t&&t[0]===e?(t[0]=t[1]=void 0,!0):!1},has:function(e){var t=e[this.name];return t?t[0]===e:!1}},window.WeakMap=n}(),function(e){function t(e){g.push(e),b||(b=!0,m(r))}function n(e){return window.ShadowDOMPolyfill&&window.ShadowDOMPolyfill.wrapIfNeeded(e)||e}function r(){b=!1;var e=g;g=[],e.sort(function(e,t){return e.uid_-t.uid_});var t=!1;e.forEach(function(e){var n=e.takeRecords();o(e),n.length&&(e.callback_(n,e),t=!0)}),t&&r()}function o(e){e.nodes_.forEach(function(t){var n=v.get(t);n&&n.forEach(function(t){t.observer===e&&t.removeTransientObservers()})})}function i(e,t){for(var n=e;n;n=n.parentNode){var r=v.get(n);if(r)for(var o=0;o0){var o=n[r-1],i=p(o,e);if(i)return void(n[r-1]=i)}else t(this.observer);n[r]=e},addListeners:function(){this.addListeners_(this.target)},addListeners_:function(e){var t=this.options;t.attributes&&e.addEventListener("DOMAttrModified",this,!0),t.characterData&&e.addEventListener("DOMCharacterDataModified",this,!0),t.childList&&e.addEventListener("DOMNodeInserted",this,!0),(t.childList||t.subtree)&&e.addEventListener("DOMNodeRemoved",this,!0)},removeListeners:function(){this.removeListeners_(this.target)},removeListeners_:function(e){var t=this.options;t.attributes&&e.removeEventListener("DOMAttrModified",this,!0),t.characterData&&e.removeEventListener("DOMCharacterDataModified",this,!0),t.childList&&e.removeEventListener("DOMNodeInserted",this,!0),(t.childList||t.subtree)&&e.removeEventListener("DOMNodeRemoved",this,!0)},addTransientObserver:function(e){if(e!==this.target){this.addListeners_(e),this.transientObservedNodes.push(e);var t=v.get(e);t||v.set(e,t=[]),t.push(this)}},removeTransientObservers:function(){var e=this.transientObservedNodes;this.transientObservedNodes=[],e.forEach(function(e){this.removeListeners_(e);for(var t=v.get(e),n=0;np&&(h=s[p]);p++)a(h)?(c++,n()):(h.addEventListener("load",r),h.addEventListener("error",i));else n()}function a(e){return l?e.__loaded||e["import"]&&"loading"!==e["import"].readyState:e.__importParsed}function s(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)c(t)&&d(t)}function c(e){return"link"===e.localName&&"import"===e.rel}function d(e){var t=e["import"];t?o({target:e}):(e.addEventListener("load",o),e.addEventListener("error",o))}var u="import",l=Boolean(u in document.createElement("link")),h=Boolean(window.ShadowDOMPolyfill),p=function(e){return h?window.ShadowDOMPolyfill.wrapIfNeeded(e):e},f=p(document),m={get:function(){var e=window.HTMLImports.currentScript||document.currentScript||("complete"!==document.readyState?document.scripts[document.scripts.length-1]:null);return p(e)},configurable:!0};Object.defineProperty(document,"_currentScript",m),Object.defineProperty(f,"_currentScript",m);var v=/Trident/.test(navigator.userAgent),_=v?"complete":"interactive",w="readystatechange";l&&(new MutationObserver(function(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)t.addedNodes&&s(t.addedNodes)}).observe(document.head,{childList:!0}),function(){if("loading"===document.readyState)for(var e,t=document.querySelectorAll("link[rel=import]"),n=0,r=t.length;r>n&&(e=t[n]);n++)d(e)}()),t(function(e){window.HTMLImports.ready=!0,window.HTMLImports.readyTime=(new Date).getTime();var t=f.createEvent("CustomEvent");t.initCustomEvent("HTMLImportsLoaded",!0,!0,e),f.dispatchEvent(t)}),e.IMPORT_LINK_TYPE=u,e.useNative=l,e.rootDocument=f,e.whenReady=t,e.isIE=v}(window.HTMLImports),function(e){var t=[],n=function(e){t.push(e)},r=function(){t.forEach(function(t){t(e)})};e.addModule=n,e.initializeModules=r}(window.HTMLImports),window.HTMLImports.addModule(function(e){var t=/(url\()([^)]*)(\))/g,n=/(@import[\s]+(?!url\())([^;]*)(;)/g,r={resolveUrlsInStyle:function(e,t){var n=e.ownerDocument,r=n.createElement("a");return e.textContent=this.resolveUrlsInCssText(e.textContent,t,r),e},resolveUrlsInCssText:function(e,r,o){var i=this.replaceUrls(e,o,r,t);return i=this.replaceUrls(i,o,r,n)},replaceUrls:function(e,t,n,r){return e.replace(r,function(e,r,o,i){var a=o.replace(/["']/g,"");return n&&(a=new URL(a,n).href),t.href=a,a=t.href,r+"'"+a+"'"+i})}};e.path=r}),window.HTMLImports.addModule(function(e){var t={async:!0,ok:function(e){return e.status>=200&&e.status<300||304===e.status||0===e.status},load:function(n,r,o){var i=new XMLHttpRequest;return(e.flags.debug||e.flags.bust)&&(n+="?"+Math.random()),i.open("GET",n,t.async),i.addEventListener("readystatechange",function(e){if(4===i.readyState){var n=i.getResponseHeader("Location"),a=null;if(n)var a="/"===n.substr(0,1)?location.origin+n:n;r.call(o,!t.ok(i)&&i,i.response||i.responseText,a)}}),i.send(),i},loadDocument:function(e,t,n){this.load(e,t,n).responseType="document"}};e.xhr=t}),window.HTMLImports.addModule(function(e){var t=e.xhr,n=e.flags,r=function(e,t){this.cache={},this.onload=e,this.oncomplete=t,this.inflight=0,this.pending={}};r.prototype={addNodes:function(e){this.inflight+=e.length;for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)this.require(t);this.checkDone()},addNode:function(e){this.inflight++,this.require(e),this.checkDone()},require:function(e){var t=e.src||e.href;e.__nodeUrl=t,this.dedupe(t,e)||this.fetch(t,e)},dedupe:function(e,t){if(this.pending[e])return this.pending[e].push(t),!0;return this.cache[e]?(this.onload(e,t,this.cache[e]),this.tail(),!0):(this.pending[e]=[t],!1)},fetch:function(e,r){if(n.load&&console.log("fetch",e,r),e)if(e.match(/^data:/)){var o=e.split(","),i=o[0],a=o[1];a=i.indexOf(";base64")>-1?atob(a):decodeURIComponent(a),setTimeout(function(){this.receive(e,r,null,a)}.bind(this),0)}else{var s=function(t,n,o){this.receive(e,r,t,n,o)}.bind(this);t.load(e,s)}else setTimeout(function(){this.receive(e,r,{error:"href must be specified"},null)}.bind(this),0)},receive:function(e,t,n,r,o){this.cache[e]=r;for(var i,a=this.pending[e],s=0,c=a.length;c>s&&(i=a[s]);s++)this.onload(e,i,r,n,o),this.tail();this.pending[e]=null},tail:function(){--this.inflight,this.checkDone()},checkDone:function(){this.inflight||this.oncomplete()}},e.Loader=r}),window.HTMLImports.addModule(function(e){var t=function(e){this.addCallback=e,this.mo=new MutationObserver(this.handler.bind(this))};t.prototype={handler:function(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)"childList"===t.type&&t.addedNodes.length&&this.addedNodes(t.addedNodes)},addedNodes:function(e){this.addCallback&&this.addCallback(e);for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)t.children&&t.children.length&&this.addedNodes(t.children)},observe:function(e){this.mo.observe(e,{childList:!0,subtree:!0})}},e.Observer=t}),window.HTMLImports.addModule(function(e){function t(e){return"link"===e.localName&&e.rel===u}function n(e){var t=r(e);return"data:text/javascript;charset=utf-8,"+encodeURIComponent(t)}function r(e){return e.textContent+o(e)}function o(e){var t=e.ownerDocument;t.__importedScripts=t.__importedScripts||0;var n=e.ownerDocument.baseURI,r=t.__importedScripts?"-"+t.__importedScripts:"";return t.__importedScripts++,"\n//# sourceURL="+n+r+".js\n"}function i(e){var t=e.ownerDocument.createElement("style");return t.textContent=e.textContent,a.resolveUrlsInStyle(t),t}var a=e.path,s=e.rootDocument,c=e.flags,d=e.isIE,u=e.IMPORT_LINK_TYPE,l="link[rel="+u+"]",h={documentSelectors:l,importsSelectors:[l,"link[rel=stylesheet]","style","script:not([type])",'script[type="application/javascript"]','script[type="text/javascript"]'].join(","),map:{link:"parseLink",script:"parseScript",style:"parseStyle"},dynamicElements:[],parseNext:function(){var e=this.nextToParse();e&&this.parse(e)},parse:function(e){if(this.isParsed(e))return void(c.parse&&console.log("[%s] is already parsed",e.localName));var t=this[this.map[e.localName]];t&&(this.markParsing(e),t.call(this,e))},parseDynamic:function(e,t){this.dynamicElements.push(e),t||this.parseNext()},markParsing:function(e){c.parse&&console.log("parsing",e),this.parsingElement=e},markParsingComplete:function(e){e.__importParsed=!0,this.markDynamicParsingComplete(e),e.__importElement&&(e.__importElement.__importParsed=!0,this.markDynamicParsingComplete(e.__importElement)),this.parsingElement=null,c.parse&&console.log("completed",e)},markDynamicParsingComplete:function(e){var t=this.dynamicElements.indexOf(e);t>=0&&this.dynamicElements.splice(t,1)},parseImport:function(e){if(window.HTMLImports.__importsParsingHook&&window.HTMLImports.__importsParsingHook(e),e["import"]&&(e["import"].__importParsed=!0),this.markParsingComplete(e),e.dispatchEvent(e.__resource&&!e.__error?new CustomEvent("load",{bubbles:!1}):new CustomEvent("error",{bubbles:!1})),e.__pending)for(var t;e.__pending.length;)t=e.__pending.shift(),t&&t({target:e});this.parseNext()},parseLink:function(e){t(e)?this.parseImport(e):(e.href=e.href,this.parseGeneric(e))},parseStyle:function(e){var t=e;e=i(e),t.__appliedElement=e,e.__importElement=t,this.parseGeneric(e)},parseGeneric:function(e){this.trackElement(e),this.addElementToDocument(e)},rootImportForElement:function(e){for(var t=e;t.ownerDocument.__importLink;)t=t.ownerDocument.__importLink;return t},addElementToDocument:function(e){var t=this.rootImportForElement(e.__importElement||e);t.parentNode.insertBefore(e,t)},trackElement:function(e,t){var n=this,r=function(r){t&&t(r),n.markParsingComplete(e),n.parseNext()};if(e.addEventListener("load",r),e.addEventListener("error",r),d&&"style"===e.localName){var o=!1;if(-1==e.textContent.indexOf("@import"))o=!0;else if(e.sheet){o=!0;for(var i,a=e.sheet.cssRules,s=a?a.length:0,c=0;s>c&&(i=a[c]);c++)i.type===CSSRule.IMPORT_RULE&&(o=o&&Boolean(i.styleSheet))}o&&setTimeout(function(){e.dispatchEvent(new CustomEvent("load",{bubbles:!1}))})}},parseScript:function(t){var r=document.createElement("script");r.__importElement=t,r.src=t.src?t.src:n(t),e.currentScript=t,this.trackElement(r,function(t){r.parentNode.removeChild(r),e.currentScript=null}),this.addElementToDocument(r)},nextToParse:function(){return this._mayParse=[],!this.parsingElement&&(this.nextToParseInDoc(s)||this.nextToParseDynamic())},nextToParseInDoc:function(e,n){if(e&&this._mayParse.indexOf(e)<0){this._mayParse.push(e);for(var r,o=e.querySelectorAll(this.parseSelectorsForNode(e)),i=0,a=o.length;a>i&&(r=o[i]);i++)if(!this.isParsed(r))return this.hasResource(r)?t(r)?this.nextToParseInDoc(r["import"],r):r:void 0}return n},nextToParseDynamic:function(){return this.dynamicElements[0]},parseSelectorsForNode:function(e){var t=e.ownerDocument||e;return t===s?this.documentSelectors:this.importsSelectors},isParsed:function(e){return e.__importParsed},needsDynamicParsing:function(e){return this.dynamicElements.indexOf(e)>=0},hasResource:function(e){return t(e)&&void 0===e["import"]?!1:!0}};e.parser=h,e.IMPORT_SELECTOR=l}),window.HTMLImports.addModule(function(e){function t(e){return n(e,a)}function n(e,t){return"link"===e.localName&&e.getAttribute("rel")===t}function r(e){return!!Object.getOwnPropertyDescriptor(e,"baseURI")}function o(e,t){var n=document.implementation.createHTMLDocument(a);n._URL=t;var o=n.createElement("base");o.setAttribute("href",t),n.baseURI||r(n)||Object.defineProperty(n,"baseURI",{value:t});var i=n.createElement("meta");return i.setAttribute("charset","utf-8"),n.head.appendChild(i),n.head.appendChild(o),n.body.innerHTML=e,window.HTMLTemplateElement&&HTMLTemplateElement.bootstrap&&HTMLTemplateElement.bootstrap(n),n}var i=e.flags,a=e.IMPORT_LINK_TYPE,s=e.IMPORT_SELECTOR,c=e.rootDocument,d=e.Loader,u=e.Observer,l=e.parser,h={documents:{},documentPreloadSelectors:s,importsPreloadSelectors:[s].join(","),loadNode:function(e){p.addNode(e)},loadSubtree:function(e){var t=this.marshalNodes(e);p.addNodes(t)},marshalNodes:function(e){return e.querySelectorAll(this.loadSelectorsForNode(e))},loadSelectorsForNode:function(e){var t=e.ownerDocument||e;return t===c?this.documentPreloadSelectors:this.importsPreloadSelectors},loaded:function(e,n,r,a,s){if(i.load&&console.log("loaded",e,n),n.__resource=r,n.__error=a,t(n)){var c=this.documents[e];void 0===c&&(c=a?null:o(r,s||e),c&&(c.__importLink=n,this.bootDocument(c)),this.documents[e]=c),n["import"]=c}l.parseNext()},bootDocument:function(e){this.loadSubtree(e),this.observer.observe(e),l.parseNext()},loadedAll:function(){l.parseNext()}},p=new d(h.loaded.bind(h),h.loadedAll.bind(h));if(h.observer=new u,!document.baseURI){var f={get:function(){var e=document.querySelector("base");return e?e.href:window.location.href},configurable:!0};Object.defineProperty(document,"baseURI",f),Object.defineProperty(c,"baseURI",f)}e.importer=h,e.importLoader=p}),window.HTMLImports.addModule(function(e){var t=e.parser,n=e.importer,r={added:function(e){for(var r,o,i,a,s=0,c=e.length;c>s&&(a=e[s]);s++)r||(r=a.ownerDocument,o=t.isParsed(r)),i=this.shouldLoadNode(a),i&&n.loadNode(a),this.shouldParseNode(a)&&o&&t.parseDynamic(a,i)},shouldLoadNode:function(e){return 1===e.nodeType&&o.call(e,n.loadSelectorsForNode(e))},shouldParseNode:function(e){return 1===e.nodeType&&o.call(e,t.parseSelectorsForNode(e))}};n.observer.addCallback=r.added.bind(r);var o=HTMLElement.prototype.matches||HTMLElement.prototype.matchesSelector||HTMLElement.prototype.webkitMatchesSelector||HTMLElement.prototype.mozMatchesSelector||HTMLElement.prototype.msMatchesSelector}),function(e){function t(){window.HTMLImports.importer.bootDocument(o)}var n=e.initializeModules,r=e.isIE;if(!e.useNative){r&&"function"!=typeof window.CustomEvent&&(window.CustomEvent=function(e,t){t=t||{};var n=document.createEvent("CustomEvent");return n.initCustomEvent(e,Boolean(t.bubbles),Boolean(t.cancelable),t.detail),n.preventDefault=function(){Object.defineProperty(this,"defaultPrevented",{get:function(){return!0}})},n},window.CustomEvent.prototype=window.Event.prototype),n();var o=e.rootDocument;"complete"===document.readyState||"interactive"===document.readyState&&!window.attachEvent?t():document.addEventListener("DOMContentLoaded",t)}}(window.HTMLImports),window.CustomElements=window.CustomElements||{flags:{}},function(e){var t=e.flags,n=[],r=function(e){n.push(e)},o=function(){n.forEach(function(t){t(e)})};e.addModule=r,e.initializeModules=o,e.hasNative=Boolean(document.registerElement),e.useNative=!t.register&&e.hasNative&&!window.ShadowDOMPolyfill&&(!window.HTMLImports||window.HTMLImports.useNative)}(window.CustomElements),window.CustomElements.addModule(function(e){function t(e,t){n(e,function(e){return t(e)?!0:void r(e,t)}),r(e,t)}function n(e,t,r){var o=e.firstElementChild;if(!o)for(o=e.firstChild;o&&o.nodeType!==Node.ELEMENT_NODE;)o=o.nextSibling;for(;o;)t(o,r)!==!0&&n(o,t,r),o=o.nextElementSibling;return null}function r(e,n){for(var r=e.shadowRoot;r;)t(r,n),r=r.olderShadowRoot}function o(e,t){i(e,t,[])}function i(e,t,n){if(e=window.wrap(e),!(n.indexOf(e)>=0)){n.push(e);for(var r,o=e.querySelectorAll("link[rel="+a+"]"),s=0,c=o.length;c>s&&(r=o[s]);s++)r["import"]&&i(r["import"],t,n);t(e)}}var a=window.HTMLImports?window.HTMLImports.IMPORT_LINK_TYPE:"none";e.forDocumentTree=o,e.forSubtree=t}),window.CustomElements.addModule(function(e){function t(e){return n(e)||r(e)}function n(t){return e.upgrade(t)?!0:void s(t)}function r(e){g(e,function(e){return n(e)?!0:void 0})}function o(e){s(e),h(e)&&g(e,function(e){s(e)})}function i(e){M.push(e),L||(L=!0,setTimeout(a))}function a(){L=!1;for(var e,t=M,n=0,r=t.length;r>n&&(e=t[n]);n++)e();M=[]}function s(e){E?i(function(){c(e)}):c(e)}function c(e){e.__upgraded__&&(e.attachedCallback||e.detachedCallback)&&!e.__attached&&h(e)&&(e.__attached=!0,e.attachedCallback&&e.attachedCallback())}function d(e){u(e),g(e,function(e){u(e)})}function u(e){E?i(function(){l(e)}):l(e)}function l(e){e.__upgraded__&&(e.attachedCallback||e.detachedCallback)&&e.__attached&&!h(e)&&(e.__attached=!1,e.detachedCallback&&e.detachedCallback())}function h(e){for(var t=e,n=wrap(document);t;){if(t==n)return!0;t=t.parentNode||t.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&t.host}}function p(e){if(e.shadowRoot&&!e.shadowRoot.__watched){b.dom&&console.log("watching shadow-root for: ",e.localName);for(var t=e.shadowRoot;t;)v(t),t=t.olderShadowRoot}}function f(e){if(b.dom){var n=e[0];if(n&&"childList"===n.type&&n.addedNodes&&n.addedNodes){for(var r=n.addedNodes[0];r&&r!==document&&!r.host;)r=r.parentNode;var o=r&&(r.URL||r._URL||r.host&&r.host.localName)||"";o=o.split("/?").shift().split("/").pop()}console.group("mutations (%d) [%s]",e.length,o||"")}e.forEach(function(e){"childList"===e.type&&(T(e.addedNodes,function(e){e.localName&&t(e)}),T(e.removedNodes,function(e){e.localName&&d(e)}))}),b.dom&&console.groupEnd()}function m(e){for(e=window.wrap(e),e||(e=window.wrap(document));e.parentNode;)e=e.parentNode;var t=e.__observer;t&&(f(t.takeRecords()),a())}function v(e){if(!e.__observer){var t=new MutationObserver(f);t.observe(e,{childList:!0,subtree:!0}),e.__observer=t}}function _(e){e=window.wrap(e),b.dom&&console.group("upgradeDocument: ",e.baseURI.split("/").pop()),t(e),v(e),b.dom&&console.groupEnd()}function w(e){y(e,_)}var b=e.flags,g=e.forSubtree,y=e.forDocumentTree,E=!window.MutationObserver||window.MutationObserver===window.JsMutationObserver;e.hasPolyfillMutations=E;var L=!1,M=[],T=Array.prototype.forEach.call.bind(Array.prototype.forEach),N=Element.prototype.createShadowRoot;N&&(Element.prototype.createShadowRoot=function(){var e=N.call(this);return window.CustomElements.watchShadow(this),e}),e.watchShadow=p,e.upgradeDocumentTree=w,e.upgradeSubtree=r,e.upgradeAll=t,e.attachedNode=o,e.takeRecords=m}),window.CustomElements.addModule(function(e){function t(t){if(!t.__upgraded__&&t.nodeType===Node.ELEMENT_NODE){var r=t.getAttribute("is"),o=e.getRegisteredDefinition(r||t.localName);if(o){if(r&&o.tag==t.localName)return n(t,o);if(!r&&!o["extends"])return n(t,o)}}}function n(t,n){return a.upgrade&&console.group("upgrade:",t.localName),n.is&&t.setAttribute("is",n.is),r(t,n),t.__upgraded__=!0,i(t),e.attachedNode(t),e.upgradeSubtree(t),a.upgrade&&console.groupEnd(),t}function r(e,t){Object.__proto__?e.__proto__=t.prototype:(o(e,t.prototype,t["native"]),e.__proto__=t.prototype)}function o(e,t,n){for(var r={},o=t;o!==n&&o!==HTMLElement.prototype;){for(var i,a=Object.getOwnPropertyNames(o),s=0;i=a[s];s++)r[i]||(Object.defineProperty(e,i,Object.getOwnPropertyDescriptor(o,i)),r[i]=1);o=Object.getPrototypeOf(o)}}function i(e){e.createdCallback&&e.createdCallback()}var a=e.flags;e.upgrade=t,e.upgradeWithDefinition=n,e.implementPrototype=r}),window.CustomElements.addModule(function(e){function t(t,r){var c=r||{};if(!t)throw new Error("document.registerElement: first argument `name` must not be empty");if(t.indexOf("-")<0)throw new Error("document.registerElement: first argument ('name') must contain a dash ('-'). Argument provided was '"+String(t)+"'.");if(o(t))throw new Error("Failed to execute 'registerElement' on 'Document': Registration failed for type '"+String(t)+"'. The type name is invalid.");if(d(t))throw new Error("DuplicateDefinitionError: a type with name '"+String(t)+"' is already registered");return c.prototype||(c.prototype=Object.create(HTMLElement.prototype)),c.__name=t.toLowerCase(),c.lifecycle=c.lifecycle||{},c.ancestry=i(c["extends"]),a(c),s(c),n(c.prototype),u(c.__name,c),c.ctor=l(c),c.ctor.prototype=c.prototype,c.prototype.constructor=c.ctor,e.ready&&_(document),c.ctor}function n(e){if(!e.setAttribute._polyfilled){var t=e.setAttribute;e.setAttribute=function(e,n){r.call(this,e,n,t)};var n=e.removeAttribute;e.removeAttribute=function(e){r.call(this,e,null,n); +// @version 0.7.6 +window.WebComponents=window.WebComponents||{},function(e){var t=e.flags||{},n="webcomponents-lite.js",r=document.querySelector('script[src*="'+n+'"]');if(!t.noOpts){if(location.search.slice(1).split("&").forEach(function(e){var n,r=e.split("=");r[0]&&(n=r[0].match(/wc-(.+)/))&&(t[n[1]]=r[1]||!0)}),r)for(var o,i=0;o=r.attributes[i];i++)"src"!==o.name&&(t[o.name]=o.value||!0);if(t.log){var a=t.log.split(",");t.log={},a.forEach(function(e){t.log[e]=!0})}else t.log={}}t.shadow=t.shadow||t.shadowdom||t.polyfill,t.shadow="native"===t.shadow?!1:t.shadow||!HTMLElement.prototype.createShadowRoot,t.register&&(window.CustomElements=window.CustomElements||{flags:{}},window.CustomElements.flags.register=t.register),e.flags=t}(window.WebComponents),function(e){"use strict";function t(e){return void 0!==h[e]}function n(){s.call(this),this._isInvalid=!0}function r(e){return""==e&&n.call(this),e.toLowerCase()}function o(e){var t=e.charCodeAt(0);return t>32&&127>t&&-1==[34,35,60,62,63,96].indexOf(t)?e:encodeURIComponent(e)}function i(e){var t=e.charCodeAt(0);return t>32&&127>t&&-1==[34,35,60,62,96].indexOf(t)?e:encodeURIComponent(e)}function a(e,a,s){function c(e){g.push(e)}var d=a||"scheme start",u=0,l="",_=!1,w=!1,g=[];e:for(;(e[u-1]!=f||0==u)&&!this._isInvalid;){var b=e[u];switch(d){case"scheme start":if(!b||!m.test(b)){if(a){c("Invalid scheme.");break e}l="",d="no scheme";continue}l+=b.toLowerCase(),d="scheme";break;case"scheme":if(b&&v.test(b))l+=b.toLowerCase();else{if(":"!=b){if(a){if(f==b)break e;c("Code point not allowed in scheme: "+b);break e}l="",u=0,d="no scheme";continue}if(this._scheme=l,l="",a)break e;t(this._scheme)&&(this._isRelative=!0),d="file"==this._scheme?"relative":this._isRelative&&s&&s._scheme==this._scheme?"relative or authority":this._isRelative?"authority first slash":"scheme data"}break;case"scheme data":"?"==b?(this._query="?",d="query"):"#"==b?(this._fragment="#",d="fragment"):f!=b&&" "!=b&&"\n"!=b&&"\r"!=b&&(this._schemeData+=o(b));break;case"no scheme":if(s&&t(s._scheme)){d="relative";continue}c("Missing scheme."),n.call(this);break;case"relative or authority":if("/"!=b||"/"!=e[u+1]){c("Expected /, got: "+b),d="relative";continue}d="authority ignore slashes";break;case"relative":if(this._isRelative=!0,"file"!=this._scheme&&(this._scheme=s._scheme),f==b){this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query=s._query,this._username=s._username,this._password=s._password;break e}if("/"==b||"\\"==b)"\\"==b&&c("\\ is an invalid code point."),d="relative slash";else if("?"==b)this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query="?",this._username=s._username,this._password=s._password,d="query";else{if("#"!=b){var y=e[u+1],E=e[u+2];("file"!=this._scheme||!m.test(b)||":"!=y&&"|"!=y||f!=E&&"/"!=E&&"\\"!=E&&"?"!=E&&"#"!=E)&&(this._host=s._host,this._port=s._port,this._username=s._username,this._password=s._password,this._path=s._path.slice(),this._path.pop()),d="relative path";continue}this._host=s._host,this._port=s._port,this._path=s._path.slice(),this._query=s._query,this._fragment="#",this._username=s._username,this._password=s._password,d="fragment"}break;case"relative slash":if("/"!=b&&"\\"!=b){"file"!=this._scheme&&(this._host=s._host,this._port=s._port,this._username=s._username,this._password=s._password),d="relative path";continue}"\\"==b&&c("\\ is an invalid code point."),d="file"==this._scheme?"file host":"authority ignore slashes";break;case"authority first slash":if("/"!=b){c("Expected '/', got: "+b),d="authority ignore slashes";continue}d="authority second slash";break;case"authority second slash":if(d="authority ignore slashes","/"!=b){c("Expected '/', got: "+b);continue}break;case"authority ignore slashes":if("/"!=b&&"\\"!=b){d="authority";continue}c("Expected authority, got: "+b);break;case"authority":if("@"==b){_&&(c("@ already seen."),l+="%40"),_=!0;for(var L=0;L>>0)+(t++ +"__")};n.prototype={set:function(t,n){var r=t[this.name];return r&&r[0]===t?r[1]=n:e(t,this.name,{value:[t,n],writable:!0}),this},get:function(e){var t;return(t=e[this.name])&&t[0]===e?t[1]:void 0},"delete":function(e){var t=e[this.name];return t&&t[0]===e?(t[0]=t[1]=void 0,!0):!1},has:function(e){var t=e[this.name];return t?t[0]===e:!1}},window.WeakMap=n}(),function(e){function t(e){b.push(e),g||(g=!0,m(r))}function n(e){return window.ShadowDOMPolyfill&&window.ShadowDOMPolyfill.wrapIfNeeded(e)||e}function r(){g=!1;var e=b;b=[],e.sort(function(e,t){return e.uid_-t.uid_});var t=!1;e.forEach(function(e){var n=e.takeRecords();o(e),n.length&&(e.callback_(n,e),t=!0)}),t&&r()}function o(e){e.nodes_.forEach(function(t){var n=v.get(t);n&&n.forEach(function(t){t.observer===e&&t.removeTransientObservers()})})}function i(e,t){for(var n=e;n;n=n.parentNode){var r=v.get(n);if(r)for(var o=0;o0){var o=n[r-1],i=p(o,e);if(i)return void(n[r-1]=i)}else t(this.observer);n[r]=e},addListeners:function(){this.addListeners_(this.target)},addListeners_:function(e){var t=this.options;t.attributes&&e.addEventListener("DOMAttrModified",this,!0),t.characterData&&e.addEventListener("DOMCharacterDataModified",this,!0),t.childList&&e.addEventListener("DOMNodeInserted",this,!0),(t.childList||t.subtree)&&e.addEventListener("DOMNodeRemoved",this,!0)},removeListeners:function(){this.removeListeners_(this.target)},removeListeners_:function(e){var t=this.options;t.attributes&&e.removeEventListener("DOMAttrModified",this,!0),t.characterData&&e.removeEventListener("DOMCharacterDataModified",this,!0),t.childList&&e.removeEventListener("DOMNodeInserted",this,!0),(t.childList||t.subtree)&&e.removeEventListener("DOMNodeRemoved",this,!0)},addTransientObserver:function(e){if(e!==this.target){this.addListeners_(e),this.transientObservedNodes.push(e);var t=v.get(e);t||v.set(e,t=[]),t.push(this)}},removeTransientObservers:function(){var e=this.transientObservedNodes;this.transientObservedNodes=[],e.forEach(function(e){this.removeListeners_(e);for(var t=v.get(e),n=0;np&&(h=s[p]);p++)a(h)?(c++,n()):(h.addEventListener("load",r),h.addEventListener("error",i));else n()}function a(e){return l?e.__loaded||e["import"]&&"loading"!==e["import"].readyState:e.__importParsed}function s(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)c(t)&&d(t)}function c(e){return"link"===e.localName&&"import"===e.rel}function d(e){var t=e["import"];t?o({target:e}):(e.addEventListener("load",o),e.addEventListener("error",o))}var u="import",l=Boolean(u in document.createElement("link")),h=Boolean(window.ShadowDOMPolyfill),p=function(e){return h?window.ShadowDOMPolyfill.wrapIfNeeded(e):e},f=p(document),m={get:function(){var e=window.HTMLImports.currentScript||document.currentScript||("complete"!==document.readyState?document.scripts[document.scripts.length-1]:null);return p(e)},configurable:!0};Object.defineProperty(document,"_currentScript",m),Object.defineProperty(f,"_currentScript",m);var v=/Trident/.test(navigator.userAgent),_=v?"complete":"interactive",w="readystatechange";l&&(new MutationObserver(function(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)t.addedNodes&&s(t.addedNodes)}).observe(document.head,{childList:!0}),function(){if("loading"===document.readyState)for(var e,t=document.querySelectorAll("link[rel=import]"),n=0,r=t.length;r>n&&(e=t[n]);n++)d(e)}()),t(function(e){window.HTMLImports.ready=!0,window.HTMLImports.readyTime=(new Date).getTime();var t=f.createEvent("CustomEvent");t.initCustomEvent("HTMLImportsLoaded",!0,!0,e),f.dispatchEvent(t)}),e.IMPORT_LINK_TYPE=u,e.useNative=l,e.rootDocument=f,e.whenReady=t,e.isIE=v}(window.HTMLImports),function(e){var t=[],n=function(e){t.push(e)},r=function(){t.forEach(function(t){t(e)})};e.addModule=n,e.initializeModules=r}(window.HTMLImports),window.HTMLImports.addModule(function(e){var t=/(url\()([^)]*)(\))/g,n=/(@import[\s]+(?!url\())([^;]*)(;)/g,r={resolveUrlsInStyle:function(e,t){var n=e.ownerDocument,r=n.createElement("a");return e.textContent=this.resolveUrlsInCssText(e.textContent,t,r),e},resolveUrlsInCssText:function(e,r,o){var i=this.replaceUrls(e,o,r,t);return i=this.replaceUrls(i,o,r,n)},replaceUrls:function(e,t,n,r){return e.replace(r,function(e,r,o,i){var a=o.replace(/["']/g,"");return n&&(a=new URL(a,n).href),t.href=a,a=t.href,r+"'"+a+"'"+i})}};e.path=r}),window.HTMLImports.addModule(function(e){var t={async:!0,ok:function(e){return e.status>=200&&e.status<300||304===e.status||0===e.status},load:function(n,r,o){var i=new XMLHttpRequest;return(e.flags.debug||e.flags.bust)&&(n+="?"+Math.random()),i.open("GET",n,t.async),i.addEventListener("readystatechange",function(e){if(4===i.readyState){var n=i.getResponseHeader("Location"),a=null;if(n)var a="/"===n.substr(0,1)?location.origin+n:n;r.call(o,!t.ok(i)&&i,i.response||i.responseText,a)}}),i.send(),i},loadDocument:function(e,t,n){this.load(e,t,n).responseType="document"}};e.xhr=t}),window.HTMLImports.addModule(function(e){var t=e.xhr,n=e.flags,r=function(e,t){this.cache={},this.onload=e,this.oncomplete=t,this.inflight=0,this.pending={}};r.prototype={addNodes:function(e){this.inflight+=e.length;for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)this.require(t);this.checkDone()},addNode:function(e){this.inflight++,this.require(e),this.checkDone()},require:function(e){var t=e.src||e.href;e.__nodeUrl=t,this.dedupe(t,e)||this.fetch(t,e)},dedupe:function(e,t){if(this.pending[e])return this.pending[e].push(t),!0;return this.cache[e]?(this.onload(e,t,this.cache[e]),this.tail(),!0):(this.pending[e]=[t],!1)},fetch:function(e,r){if(n.load&&console.log("fetch",e,r),e)if(e.match(/^data:/)){var o=e.split(","),i=o[0],a=o[1];a=i.indexOf(";base64")>-1?atob(a):decodeURIComponent(a),setTimeout(function(){this.receive(e,r,null,a)}.bind(this),0)}else{var s=function(t,n,o){this.receive(e,r,t,n,o)}.bind(this);t.load(e,s)}else setTimeout(function(){this.receive(e,r,{error:"href must be specified"},null)}.bind(this),0)},receive:function(e,t,n,r,o){this.cache[e]=r;for(var i,a=this.pending[e],s=0,c=a.length;c>s&&(i=a[s]);s++)this.onload(e,i,r,n,o),this.tail();this.pending[e]=null},tail:function(){--this.inflight,this.checkDone()},checkDone:function(){this.inflight||this.oncomplete()}},e.Loader=r}),window.HTMLImports.addModule(function(e){var t=function(e){this.addCallback=e,this.mo=new MutationObserver(this.handler.bind(this))};t.prototype={handler:function(e){for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)"childList"===t.type&&t.addedNodes.length&&this.addedNodes(t.addedNodes)},addedNodes:function(e){this.addCallback&&this.addCallback(e);for(var t,n=0,r=e.length;r>n&&(t=e[n]);n++)t.children&&t.children.length&&this.addedNodes(t.children)},observe:function(e){this.mo.observe(e,{childList:!0,subtree:!0})}},e.Observer=t}),window.HTMLImports.addModule(function(e){function t(e){return"link"===e.localName&&e.rel===u}function n(e){var t=r(e);return"data:text/javascript;charset=utf-8,"+encodeURIComponent(t)}function r(e){return e.textContent+o(e)}function o(e){var t=e.ownerDocument;t.__importedScripts=t.__importedScripts||0;var n=e.ownerDocument.baseURI,r=t.__importedScripts?"-"+t.__importedScripts:"";return t.__importedScripts++,"\n//# sourceURL="+n+r+".js\n"}function i(e){var t=e.ownerDocument.createElement("style");return t.textContent=e.textContent,a.resolveUrlsInStyle(t),t}var a=e.path,s=e.rootDocument,c=e.flags,d=e.isIE,u=e.IMPORT_LINK_TYPE,l="link[rel="+u+"]",h={documentSelectors:l,importsSelectors:[l,"link[rel=stylesheet]","style","script:not([type])",'script[type="application/javascript"]','script[type="text/javascript"]'].join(","),map:{link:"parseLink",script:"parseScript",style:"parseStyle"},dynamicElements:[],parseNext:function(){var e=this.nextToParse();e&&this.parse(e)},parse:function(e){if(this.isParsed(e))return void(c.parse&&console.log("[%s] is already parsed",e.localName));var t=this[this.map[e.localName]];t&&(this.markParsing(e),t.call(this,e))},parseDynamic:function(e,t){this.dynamicElements.push(e),t||this.parseNext()},markParsing:function(e){c.parse&&console.log("parsing",e),this.parsingElement=e},markParsingComplete:function(e){e.__importParsed=!0,this.markDynamicParsingComplete(e),e.__importElement&&(e.__importElement.__importParsed=!0,this.markDynamicParsingComplete(e.__importElement)),this.parsingElement=null,c.parse&&console.log("completed",e)},markDynamicParsingComplete:function(e){var t=this.dynamicElements.indexOf(e);t>=0&&this.dynamicElements.splice(t,1)},parseImport:function(e){if(window.HTMLImports.__importsParsingHook&&window.HTMLImports.__importsParsingHook(e),e["import"]&&(e["import"].__importParsed=!0),this.markParsingComplete(e),e.dispatchEvent(e.__resource&&!e.__error?new CustomEvent("load",{bubbles:!1}):new CustomEvent("error",{bubbles:!1})),e.__pending)for(var t;e.__pending.length;)t=e.__pending.shift(),t&&t({target:e});this.parseNext()},parseLink:function(e){t(e)?this.parseImport(e):(e.href=e.href,this.parseGeneric(e))},parseStyle:function(e){var t=e;e=i(e),t.__appliedElement=e,e.__importElement=t,this.parseGeneric(e)},parseGeneric:function(e){this.trackElement(e),this.addElementToDocument(e)},rootImportForElement:function(e){for(var t=e;t.ownerDocument.__importLink;)t=t.ownerDocument.__importLink;return t},addElementToDocument:function(e){var t=this.rootImportForElement(e.__importElement||e);t.parentNode.insertBefore(e,t)},trackElement:function(e,t){var n=this,r=function(r){t&&t(r),n.markParsingComplete(e),n.parseNext()};if(e.addEventListener("load",r),e.addEventListener("error",r),d&&"style"===e.localName){var o=!1;if(-1==e.textContent.indexOf("@import"))o=!0;else if(e.sheet){o=!0;for(var i,a=e.sheet.cssRules,s=a?a.length:0,c=0;s>c&&(i=a[c]);c++)i.type===CSSRule.IMPORT_RULE&&(o=o&&Boolean(i.styleSheet))}o&&setTimeout(function(){e.dispatchEvent(new CustomEvent("load",{bubbles:!1}))})}},parseScript:function(t){var r=document.createElement("script");r.__importElement=t,r.src=t.src?t.src:n(t),e.currentScript=t,this.trackElement(r,function(t){r.parentNode&&r.parentNode.removeChild(r),e.currentScript=null}),this.addElementToDocument(r)},nextToParse:function(){return this._mayParse=[],!this.parsingElement&&(this.nextToParseInDoc(s)||this.nextToParseDynamic())},nextToParseInDoc:function(e,n){if(e&&this._mayParse.indexOf(e)<0){this._mayParse.push(e);for(var r,o=e.querySelectorAll(this.parseSelectorsForNode(e)),i=0,a=o.length;a>i&&(r=o[i]);i++)if(!this.isParsed(r))return this.hasResource(r)?t(r)?this.nextToParseInDoc(r["import"],r):r:void 0}return n},nextToParseDynamic:function(){return this.dynamicElements[0]},parseSelectorsForNode:function(e){var t=e.ownerDocument||e;return t===s?this.documentSelectors:this.importsSelectors},isParsed:function(e){return e.__importParsed},needsDynamicParsing:function(e){return this.dynamicElements.indexOf(e)>=0},hasResource:function(e){return t(e)&&void 0===e["import"]?!1:!0}};e.parser=h,e.IMPORT_SELECTOR=l}),window.HTMLImports.addModule(function(e){function t(e){return n(e,a)}function n(e,t){return"link"===e.localName&&e.getAttribute("rel")===t}function r(e){return!!Object.getOwnPropertyDescriptor(e,"baseURI")}function o(e,t){var n=document.implementation.createHTMLDocument(a);n._URL=t;var o=n.createElement("base");o.setAttribute("href",t),n.baseURI||r(n)||Object.defineProperty(n,"baseURI",{value:t});var i=n.createElement("meta");return i.setAttribute("charset","utf-8"),n.head.appendChild(i),n.head.appendChild(o),n.body.innerHTML=e,window.HTMLTemplateElement&&HTMLTemplateElement.bootstrap&&HTMLTemplateElement.bootstrap(n),n}var i=e.flags,a=e.IMPORT_LINK_TYPE,s=e.IMPORT_SELECTOR,c=e.rootDocument,d=e.Loader,u=e.Observer,l=e.parser,h={documents:{},documentPreloadSelectors:s,importsPreloadSelectors:[s].join(","),loadNode:function(e){p.addNode(e)},loadSubtree:function(e){var t=this.marshalNodes(e);p.addNodes(t)},marshalNodes:function(e){return e.querySelectorAll(this.loadSelectorsForNode(e))},loadSelectorsForNode:function(e){var t=e.ownerDocument||e;return t===c?this.documentPreloadSelectors:this.importsPreloadSelectors},loaded:function(e,n,r,a,s){if(i.load&&console.log("loaded",e,n),n.__resource=r,n.__error=a,t(n)){var c=this.documents[e];void 0===c&&(c=a?null:o(r,s||e),c&&(c.__importLink=n,this.bootDocument(c)),this.documents[e]=c),n["import"]=c}l.parseNext()},bootDocument:function(e){this.loadSubtree(e),this.observer.observe(e),l.parseNext()},loadedAll:function(){l.parseNext()}},p=new d(h.loaded.bind(h),h.loadedAll.bind(h));if(h.observer=new u,!document.baseURI){var f={get:function(){var e=document.querySelector("base");return e?e.href:window.location.href},configurable:!0};Object.defineProperty(document,"baseURI",f),Object.defineProperty(c,"baseURI",f)}e.importer=h,e.importLoader=p}),window.HTMLImports.addModule(function(e){var t=e.parser,n=e.importer,r={added:function(e){for(var r,o,i,a,s=0,c=e.length;c>s&&(a=e[s]);s++)r||(r=a.ownerDocument,o=t.isParsed(r)),i=this.shouldLoadNode(a),i&&n.loadNode(a),this.shouldParseNode(a)&&o&&t.parseDynamic(a,i)},shouldLoadNode:function(e){return 1===e.nodeType&&o.call(e,n.loadSelectorsForNode(e))},shouldParseNode:function(e){return 1===e.nodeType&&o.call(e,t.parseSelectorsForNode(e))}};n.observer.addCallback=r.added.bind(r);var o=HTMLElement.prototype.matches||HTMLElement.prototype.matchesSelector||HTMLElement.prototype.webkitMatchesSelector||HTMLElement.prototype.mozMatchesSelector||HTMLElement.prototype.msMatchesSelector}),function(e){function t(){window.HTMLImports.importer.bootDocument(o)}var n=e.initializeModules,r=e.isIE;if(!e.useNative){r&&"function"!=typeof window.CustomEvent&&(window.CustomEvent=function(e,t){t=t||{};var n=document.createEvent("CustomEvent");return n.initCustomEvent(e,Boolean(t.bubbles),Boolean(t.cancelable),t.detail),n.preventDefault=function(){Object.defineProperty(this,"defaultPrevented",{get:function(){return!0}})},n},window.CustomEvent.prototype=window.Event.prototype),n();var o=e.rootDocument;"complete"===document.readyState||"interactive"===document.readyState&&!window.attachEvent?t():document.addEventListener("DOMContentLoaded",t)}}(window.HTMLImports),window.CustomElements=window.CustomElements||{flags:{}},function(e){var t=e.flags,n=[],r=function(e){n.push(e)},o=function(){n.forEach(function(t){t(e)})};e.addModule=r,e.initializeModules=o,e.hasNative=Boolean(document.registerElement),e.useNative=!t.register&&e.hasNative&&!window.ShadowDOMPolyfill&&(!window.HTMLImports||window.HTMLImports.useNative)}(window.CustomElements),window.CustomElements.addModule(function(e){function t(e,t){n(e,function(e){return t(e)?!0:void r(e,t)}),r(e,t)}function n(e,t,r){var o=e.firstElementChild;if(!o)for(o=e.firstChild;o&&o.nodeType!==Node.ELEMENT_NODE;)o=o.nextSibling;for(;o;)t(o,r)!==!0&&n(o,t,r),o=o.nextElementSibling;return null}function r(e,n){for(var r=e.shadowRoot;r;)t(r,n),r=r.olderShadowRoot}function o(e,t){i(e,t,[])}function i(e,t,n){if(e=window.wrap(e),!(n.indexOf(e)>=0)){n.push(e);for(var r,o=e.querySelectorAll("link[rel="+a+"]"),s=0,c=o.length;c>s&&(r=o[s]);s++)r["import"]&&i(r["import"],t,n);t(e)}}var a=window.HTMLImports?window.HTMLImports.IMPORT_LINK_TYPE:"none";e.forDocumentTree=o,e.forSubtree=t}),window.CustomElements.addModule(function(e){function t(e,t){return n(e,t)||r(e,t)}function n(t,n){return e.upgrade(t,n)?!0:void(n&&a(t))}function r(e,t){g(e,function(e){return n(e,t)?!0:void 0})}function o(e){L.push(e),E||(E=!0,setTimeout(i))}function i(){E=!1;for(var e,t=L,n=0,r=t.length;r>n&&(e=t[n]);n++)e();L=[]}function a(e){y?o(function(){s(e)}):s(e)}function s(e){e.__upgraded__&&!e.__attached&&(e.__attached=!0,e.attachedCallback&&e.attachedCallback())}function c(e){d(e),g(e,function(e){d(e)})}function d(e){y?o(function(){u(e)}):u(e)}function u(e){e.__upgraded__&&e.__attached&&(e.__attached=!1,e.detachedCallback&&e.detachedCallback())}function l(e){for(var t=e,n=window.wrap(document);t;){if(t==n)return!0;t=t.parentNode||t.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&t.host}}function h(e){if(e.shadowRoot&&!e.shadowRoot.__watched){w.dom&&console.log("watching shadow-root for: ",e.localName);for(var t=e.shadowRoot;t;)m(t),t=t.olderShadowRoot}}function p(e,n){if(w.dom){var r=n[0];if(r&&"childList"===r.type&&r.addedNodes&&r.addedNodes){for(var o=r.addedNodes[0];o&&o!==document&&!o.host;)o=o.parentNode;var i=o&&(o.URL||o._URL||o.host&&o.host.localName)||"";i=i.split("/?").shift().split("/").pop()}console.group("mutations (%d) [%s]",n.length,i||"")}var a=l(e);n.forEach(function(e){"childList"===e.type&&(M(e.addedNodes,function(e){e.localName&&t(e,a)}),M(e.removedNodes,function(e){e.localName&&c(e)}))}),w.dom&&console.groupEnd()}function f(e){for(e=window.wrap(e),e||(e=window.wrap(document));e.parentNode;)e=e.parentNode;var t=e.__observer;t&&(p(e,t.takeRecords()),i())}function m(e){if(!e.__observer){var t=new MutationObserver(p.bind(this,e));t.observe(e,{childList:!0,subtree:!0}),e.__observer=t}}function v(e){e=window.wrap(e),w.dom&&console.group("upgradeDocument: ",e.baseURI.split("/").pop());var n=e===window.wrap(document);t(e,n),m(e),w.dom&&console.groupEnd()}function _(e){b(e,v)}var w=e.flags,g=e.forSubtree,b=e.forDocumentTree,y=!window.MutationObserver||window.MutationObserver===window.JsMutationObserver;e.hasPolyfillMutations=y;var E=!1,L=[],M=Array.prototype.forEach.call.bind(Array.prototype.forEach),T=Element.prototype.createShadowRoot;T&&(Element.prototype.createShadowRoot=function(){var e=T.call(this);return window.CustomElements.watchShadow(this),e}),e.watchShadow=h,e.upgradeDocumentTree=_,e.upgradeSubtree=r,e.upgradeAll=t,e.attached=a,e.takeRecords=f}),window.CustomElements.addModule(function(e){function t(t,r){if(!t.__upgraded__&&t.nodeType===Node.ELEMENT_NODE){var o=t.getAttribute("is"),i=e.getRegisteredDefinition(o||t.localName);if(i){if(o&&i.tag==t.localName)return n(t,i,r);if(!o&&!i["extends"])return n(t,i,r)}}}function n(t,n,o){return a.upgrade&&console.group("upgrade:",t.localName),n.is&&t.setAttribute("is",n.is),r(t,n),t.__upgraded__=!0,i(t),o&&e.attached(t),e.upgradeSubtree(t,o),a.upgrade&&console.groupEnd(),t}function r(e,t){Object.__proto__?e.__proto__=t.prototype:(o(e,t.prototype,t["native"]),e.__proto__=t.prototype)}function o(e,t,n){for(var r={},o=t;o!==n&&o!==HTMLElement.prototype;){for(var i,a=Object.getOwnPropertyNames(o),s=0;i=a[s];s++)r[i]||(Object.defineProperty(e,i,Object.getOwnPropertyDescriptor(o,i)),r[i]=1);o=Object.getPrototypeOf(o)}}function i(e){e.createdCallback&&e.createdCallback()}var a=e.flags;e.upgrade=t,e.upgradeWithDefinition=n,e.implementPrototype=r}),window.CustomElements.addModule(function(e){function t(t,r){var c=r||{};if(!t)throw new Error("document.registerElement: first argument `name` must not be empty");if(t.indexOf("-")<0)throw new Error("document.registerElement: first argument ('name') must contain a dash ('-'). Argument provided was '"+String(t)+"'.");if(o(t))throw new Error("Failed to execute 'registerElement' on 'Document': Registration failed for type '"+String(t)+"'. The type name is invalid.");if(d(t))throw new Error("DuplicateDefinitionError: a type with name '"+String(t)+"' is already registered");return c.prototype||(c.prototype=Object.create(HTMLElement.prototype)),c.__name=t.toLowerCase(),c.lifecycle=c.lifecycle||{},c.ancestry=i(c["extends"]),a(c),s(c),n(c.prototype),u(c.__name,c),c.ctor=l(c),c.ctor.prototype=c.prototype,c.prototype.constructor=c.ctor,e.ready&&_(document),c.ctor}function n(e){if(!e.setAttribute._polyfilled){var t=e.setAttribute;e.setAttribute=function(e,n){r.call(this,e,n,t)};var n=e.removeAttribute;e.removeAttribute=function(e){r.call(this,e,null,n)},e.setAttribute._polyfilled=!0; -},e.setAttribute._polyfilled=!0}}function r(e,t,n){e=e.toLowerCase();var r=this.getAttribute(e);n.apply(this,arguments);var o=this.getAttribute(e);this.attributeChangedCallback&&o!==r&&this.attributeChangedCallback(e,r,o)}function o(e){for(var t=0;t=0&&g(r,HTMLElement),r)}function f(e,t){var n=e[t];e[t]=function(){var e=n.apply(this,arguments);return w(e),e}}var m,v=e.isIE11OrOlder,_=e.upgradeDocumentTree,w=e.upgradeAll,b=e.upgradeWithDefinition,g=e.implementPrototype,y=e.useNative,E=["annotation-xml","color-profile","font-face","font-face-src","font-face-uri","font-face-format","font-face-name","missing-glyph"],L={},M="http://www.w3.org/1999/xhtml",T=document.createElement.bind(document),N=document.createElementNS.bind(document);m=Object.__proto__||y?function(e,t){return e instanceof t}:function(e,t){for(var n=e;n;){if(n===t.prototype)return!0;n=n.__proto__}return!1},f(Node.prototype,"cloneNode"),f(document,"importNode"),v&&!function(){var e=document.importNode;document.importNode=function(){var t=e.apply(document,arguments);if(t.nodeType==t.DOCUMENT_FRAGMENT_NODE){var n=document.createDocumentFragment();return n.appendChild(t),n}return t}}(),document.registerElement=t,document.createElement=p,document.createElementNS=h,e.registry=L,e["instanceof"]=m,e.reservedTagList=E,e.getRegisteredDefinition=d,document.register=document.registerElement}),function(e){function t(){a(window.wrap(document)),window.HTMLImports&&(window.HTMLImports.__importsParsingHook=function(e){a(wrap(e["import"]))}),window.CustomElements.ready=!0,setTimeout(function(){window.CustomElements.readyTime=Date.now(),window.HTMLImports&&(window.CustomElements.elapsed=window.CustomElements.readyTime-window.HTMLImports.readyTime),document.dispatchEvent(new CustomEvent("WebComponentsReady",{bubbles:!0}))})}var n=e.useNative,r=e.initializeModules,o=/Trident/.test(navigator.userAgent);if(n){var i=function(){};e.watchShadow=i,e.upgrade=i,e.upgradeAll=i,e.upgradeDocumentTree=i,e.upgradeSubtree=i,e.takeRecords=i,e["instanceof"]=function(e,t){return e instanceof t}}else r();var a=e.upgradeDocumentTree;if(window.wrap||(window.ShadowDOMPolyfill?(window.wrap=window.ShadowDOMPolyfill.wrapIfNeeded,window.unwrap=window.ShadowDOMPolyfill.unwrapIfNeeded):window.wrap=window.unwrap=function(e){return e}),o&&"function"!=typeof window.CustomEvent&&(window.CustomEvent=function(e,t){t=t||{};var n=document.createEvent("CustomEvent");return n.initCustomEvent(e,Boolean(t.bubbles),Boolean(t.cancelable),t.detail),n.preventDefault=function(){Object.defineProperty(this,"defaultPrevented",{get:function(){return!0}})},n},window.CustomEvent.prototype=window.Event.prototype),"complete"===document.readyState||e.flags.eager)t();else if("interactive"!==document.readyState||window.attachEvent||window.HTMLImports&&!window.HTMLImports.ready){var s=window.HTMLImports&&!window.HTMLImports.ready?"HTMLImportsLoaded":"DOMContentLoaded";window.addEventListener(s,t)}else t();e.isIE11OrOlder=o}(window.CustomElements),"undefined"==typeof HTMLTemplateElement&&!function(){var e="template";HTMLTemplateElement=function(){},HTMLTemplateElement.prototype=Object.create(HTMLElement.prototype),HTMLTemplateElement.decorate=function(e){e.content||(e.content=e.ownerDocument.createDocumentFragment());for(var t;t=e.firstChild;)e.content.appendChild(t)},HTMLTemplateElement.bootstrap=function(t){for(var n,r=t.querySelectorAll(e),o=0,i=r.length;i>o&&(n=r[o]);o++)HTMLTemplateElement.decorate(n)},window.addEventListener("DOMContentLoaded",function(){HTMLTemplateElement.bootstrap(document)});var t=document.createElement;document.createElement=function(){"use strict";var e=t.apply(document,arguments);return"template"==e.localName&&HTMLTemplateElement.decorate(e),e}}(),function(e){var t=document.createElement("style");t.textContent="body {transition: opacity ease-in 0.2s; } \nbody[unresolved] {opacity: 0; display: block; overflow: hidden; position: relative; } \n";var n=document.querySelector("head");n.insertBefore(t,n.firstChild)}(window.WebComponents); \ No newline at end of file +}}function r(e,t,n){e=e.toLowerCase();var r=this.getAttribute(e);n.apply(this,arguments);var o=this.getAttribute(e);this.attributeChangedCallback&&o!==r&&this.attributeChangedCallback(e,r,o)}function o(e){for(var t=0;t=0&&b(r,HTMLElement),r)}function f(e,t){var n=e[t];e[t]=function(){var e=n.apply(this,arguments);return w(e),e}}var m,v=e.isIE11OrOlder,_=e.upgradeDocumentTree,w=e.upgradeAll,g=e.upgradeWithDefinition,b=e.implementPrototype,y=e.useNative,E=["annotation-xml","color-profile","font-face","font-face-src","font-face-uri","font-face-format","font-face-name","missing-glyph"],L={},M="http://www.w3.org/1999/xhtml",T=document.createElement.bind(document),O=document.createElementNS.bind(document);m=Object.__proto__||y?function(e,t){return e instanceof t}:function(e,t){for(var n=e;n;){if(n===t.prototype)return!0;n=n.__proto__}return!1},f(Node.prototype,"cloneNode"),f(document,"importNode"),v&&!function(){var e=document.importNode;document.importNode=function(){var t=e.apply(document,arguments);if(t.nodeType==t.DOCUMENT_FRAGMENT_NODE){var n=document.createDocumentFragment();return n.appendChild(t),n}return t}}(),document.registerElement=t,document.createElement=p,document.createElementNS=h,e.registry=L,e["instanceof"]=m,e.reservedTagList=E,e.getRegisteredDefinition=d,document.register=document.registerElement}),function(e){function t(){a(window.wrap(document)),window.HTMLImports&&(window.HTMLImports.__importsParsingHook=function(e){a(window.wrap(e["import"]))}),window.CustomElements.ready=!0,setTimeout(function(){window.CustomElements.readyTime=Date.now(),window.HTMLImports&&(window.CustomElements.elapsed=window.CustomElements.readyTime-window.HTMLImports.readyTime),document.dispatchEvent(new CustomEvent("WebComponentsReady",{bubbles:!0}))})}var n=e.useNative,r=e.initializeModules,o=/Trident/.test(navigator.userAgent);if(n){var i=function(){};e.watchShadow=i,e.upgrade=i,e.upgradeAll=i,e.upgradeDocumentTree=i,e.upgradeSubtree=i,e.takeRecords=i,e["instanceof"]=function(e,t){return e instanceof t}}else r();var a=e.upgradeDocumentTree;if(window.wrap||(window.ShadowDOMPolyfill?(window.wrap=window.ShadowDOMPolyfill.wrapIfNeeded,window.unwrap=window.ShadowDOMPolyfill.unwrapIfNeeded):window.wrap=window.unwrap=function(e){return e}),o&&"function"!=typeof window.CustomEvent&&(window.CustomEvent=function(e,t){t=t||{};var n=document.createEvent("CustomEvent");return n.initCustomEvent(e,Boolean(t.bubbles),Boolean(t.cancelable),t.detail),n.preventDefault=function(){Object.defineProperty(this,"defaultPrevented",{get:function(){return!0}})},n},window.CustomEvent.prototype=window.Event.prototype),"complete"===document.readyState||e.flags.eager)t();else if("interactive"!==document.readyState||window.attachEvent||window.HTMLImports&&!window.HTMLImports.ready){var s=window.HTMLImports&&!window.HTMLImports.ready?"HTMLImportsLoaded":"DOMContentLoaded";window.addEventListener(s,t)}else t();e.isIE11OrOlder=o}(window.CustomElements),"undefined"==typeof HTMLTemplateElement&&!function(){var e="template";HTMLTemplateElement=function(){},HTMLTemplateElement.prototype=Object.create(HTMLElement.prototype),HTMLTemplateElement.decorate=function(e){e.content||(e.content=e.ownerDocument.createDocumentFragment());for(var t;t=e.firstChild;)e.content.appendChild(t)},HTMLTemplateElement.bootstrap=function(t){for(var n,r=t.querySelectorAll(e),o=0,i=r.length;i>o&&(n=r[o]);o++)HTMLTemplateElement.decorate(n)},window.addEventListener("DOMContentLoaded",function(){HTMLTemplateElement.bootstrap(document)});var t=document.createElement;document.createElement=function(){"use strict";var e=t.apply(document,arguments);return"template"==e.localName&&HTMLTemplateElement.decorate(e),e}}(),function(e){var t=document.createElement("style");t.textContent="body {transition: opacity ease-in 0.2s; } \nbody[unresolved] {opacity: 0; display: block; overflow: hidden; position: relative; } \n";var n=document.querySelector("head");n.insertBefore(t,n.firstChild)}(window.WebComponents); \ No newline at end of file diff --git a/source/developers/creating_components.markdown b/source/developers/creating_components.markdown index 70620e861b3..ebbd4c85c60 100644 --- a/source/developers/creating_components.markdown +++ b/source/developers/creating_components.markdown @@ -56,9 +56,9 @@ The Home Assistant object contains three objects to help you interact with the s | Object | Description | | ------ | ----------- | -| hass.states | This is the StateMachine. It allows you to set states and track when they are changed. [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L473). | -| hass.events | This is the EventBus. It allows you to trigger and listen for events.
    [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L308). | -| hass.services | This is the ServiceRegistry. It allows you to register services.
    [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L589). | +| hass.states | This is the StateMachine. It allows you to set states and track when they are changed. [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L589). | +| hass.bus | This is the EventBus. It allows you to trigger and listen for events.
    [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L387). | +| hass.services | This is the ServiceRegistry. It allows you to register services.
    [See available methods](https://github.com/balloob/home-assistant/blob/master/homeassistant/__init__.py#L738). | ### {% linkable_title Example on using the configuration parameter %} If your configuration file contains the following lines: diff --git a/source/developers/credits.markdown b/source/developers/credits.markdown index 50ea8871eba..e36fa5f4286 100644 --- a/source/developers/credits.markdown +++ b/source/developers/credits.markdown @@ -22,15 +22,19 @@ This page contains a list of people who have contributed in one way or another t - [andythigpen](https://github.com/andythigpen) - [Austin](https://github.com/trainman419) - [Azelphur](https://github.com/Azelphur) +- [Chris Mulder](https://github.com/chrisvis) +- [Daniel Iversen](https://github.com/danielhiversen) - [Edwin Smulders](https://github.com/Dutchy-) - [ettisan](https://github.com/ettisan) - [Fabian Affolter](https://github.com/fabaff) - [Finbarr Brady](https://github.com/fbradyirl) - [Geoff Norton](https://github.com/kangaroo) - [gottsman](https://github.com/gottsman) +- [Guillem Barba](https://github.com/gbarba) - [Gustav Ahlberg](https://github.com/Gyran) - [Issac Kelly](https://github.com/issackelly) - [James Cole](https://github.com/jamespcole) +- [Jeffrey Tang](https://github.com/Qrtn) - [John McLaughlin](https://github.com/loghound) - [John Williams](https://github.com/Jaidan) - [Joseph Piron](https://github.com/eagleamon) @@ -38,10 +42,13 @@ This page contains a list of people who have contributed in one way or another t - [kixam](https://github.com/kixam) - [Markus Stenberg](https://github.com/fingon) - [Michael Arnauts](https://github.com/michaelarnauts) +- [miniconfig](https://github.com/miniconfig) - [Piratonym](https://github.com/Piratonym) - [Rev Michael Greb](https://github.com/mikegrb) +- [rkabadi](https://github.com/rkabadi) - [Ryan Kraus](https://github.com/rmkraus) - [Theodor Lindquist](https://github.com/theolind) +- [vitorespindola](https://github.com/vitorespindola) - [wind-rider](https://github.com/wind-rider) This page is irregularly updated. As a base we use the Github [contributors overview](https://github.com/balloob/home-assistant/graphs/contributors) of the Home Assistant git repository and the [overview](https://github.com/balloob/home-assistant.io/graphs/contributors) for [home-assistant.io](https://home-assistant.io). If you think that you are missing, please let us know or add yourself. diff --git a/source/developers/frontend.markdown b/source/developers/frontend.markdown index 7c6322c1253..d333429ab90 100644 --- a/source/developers/frontend.markdown +++ b/source/developers/frontend.markdown @@ -9,58 +9,92 @@ sharing: true footer: true --- -Home Assistant uses [Polymer](https://www.polymer-project.org/) for the frontend. Polymer allows building encapsulated and interoperable custom elements that extend HTML itself. +Home Assistant uses [Polymer](https://www.polymer-project.org/) for the UI and [NuclearJS](http://optimizely.github.io/nuclear-js/) for all data management. + + * Polymer allows building encapsulated custom HTML elements. + [Home-Assistant-Polymer source code on GitHub.](https://github.com/balloob/home-assistant-polymer) + * NuclearJS is a reactive flux built with ImmutableJS data structures. + [Home-Assistant-JS source code on GitHub.](https://github.com/balloob/home-assistant-js) + +

    +Do not use development mode in production. Home Assistant uses aggressive caching to improve the mobile experience. This is disabled during development so that you do not have to restart the server in between changes. +

    # {% linkable_title Turning on development mode %} -Home Assistant will by default serve the compiled version of the frontend. To change it so that the components are served separately, update your `configuration.yaml` to have these lines: +Home Assistant will by default serve the compiled version of the frontend. To change it so that each component and JavaScript are served separately, update your `configuration.yaml` to have these lines: ``` http: development: 1 ``` -After turning on development mode, you will have to install the web components that the frontend depends on. You can do this by running the `build_frontend` script. +After turning on development mode, you will have to install the web components that the frontend depends on. Firing off a build of the frontend by running `scripts/build_frontend` will ensure all dependencies are installed. -

    -Do not use development mode in production. Home Assistant uses aggressive caching to improve the mobile experience. This is disabled during development so that you do not have to restart the server in between changes. -

    +Once this is done, you can start editting the webcomponents in the folder `homeassistant/components/frontend/www_static/home-assistant-polymer/src`. To see the changes you've made, simply refresh your browser. -# {% linkable_title Building the frontend %} +## {% linkable_title Enabling JavaScript backend development %} -To build the frontend you need to install node and the npm packages bower and vulcanize. +Polymer is only providing a UI toolkit for Home Assistant. All data management and interaction with the server is done by `home-assistant-js` leveraging NuclearJS. To enable JavaScript development: ```bash -npm install -g bower vulcanize +cd homeassistant/components/frontend/www_static/home-assistant-polymer/ +npm run setup_js_dev +npm run js_dev ``` -After that you can run [`./build_frontend`](https://github.com/balloob/home-assistant/blob/master/build_frontend) from the project directory. This will take all the used web components and 'vulcanize' it into a single file to be served by Home Assistant. The script also updates [`homeassistant/components/http/frontend.py`](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/frontend.py) with an MD5 hash of the frontend. +`npm run js_dev` will start the process that will ensure that your latest changes to the JavaScript files will be loaded when you refresh the page. This command has to be always running while working on home-assistant-js. + +After your changes have been accepted into the `home-assistant-js` repository, we'll have to update Home Assistant Polymer to use the latest version. This can be done by updating `package.json`. Look for the line that contains `home-assistant-js` and update the SHA to the SHA of your commit. + +# {% linkable_title Building the Polymer frontend %} + +Building a new version of the frontend is as simple as running `scripts/build_frontend`. This fires off the following commands: + + * **home-assistant-polymer**: Install NPM dependencies. + * **home-assistant-polymer**: start frontend build. + * Compile all used JavaScript to `_app_compiled.js`. + * Install Bower dependencies. + * Vulcanize all Webcomponents to `frontend.vulcan.html`. + * Minify `frontend.vulcan.html` and save it as `frontend.html`. + * Copy the webcomponents polyfill `webcomponents-lite.min.js` from **home-assistant-polymer** to `components/frontend/www_static/webcomponents-lite.min.js`. + * Copy the final frontend build `frontend.html` from **home-assistant-polymer** to `components/frontend/www_static/frontend.html`. + * Generate MD5 hash of `frontend.html` to signal caches to redownload the UI. + +

    +Polymer build architecture diagram +

    # {% linkable_title Adding state cards %} -The main interface of Home Assistant is a list of current states in the State Machine. It will filter out the group states and offers options to filter by groups on the top. +The main interface of Home Assistant is a list of the current entities and their states. For each entity in the system, a state card will be rendered. State cards will show a state badge, the name of the entity, when the state has last changed and the current state or a control to interact with it. -Currently there are two supported card types: + - * Display: shows the state on the card - * Toggle: allows the user to toggle a device on/off from the card +Some domains will be filtered out of the main view and are available through separate menu options. Examples are `group`, `script`, `scene`. -To add your own card type, follow the following steps: +The different card types can be found [here](https://github.com/balloob/home-assistant-polymer/tree/master/src/cards). - 1. Adjust the cardType property of the State class in [home-assistant-api.html](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/home-assistant-api.html) to return your new card type when appropriate. - 2. Create a new component following the naming convention state-card-CARDTYPE.html in [/cards/](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/cards/). - 3. Import your new component in [/cards/state-card-content.html](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/cards/state-card-content.html). +Adding a custom card type can be done with a few simple steps. For this example we will add a new state card for the domain `camera`: +_(All files in this example link to their source-code)_ + + 1. Add `'camera'` to the array `DOMAINS_WITH_CARD` in the file [`/util/state-card-type.js`](https://github.com/balloob/home-assistant-polymer/blob/master/src/util/state-card-type.js#L3-L4). + 2. Create the files `state-card-camera.html` and `state-card-camera.js` in the folder [`/cards/`](https://github.com/balloob/home-assistant-polymer/tree/master/src/cards). + 3. Add `require('./state-card-camera')` to [`state-card-content.js`](https://github.com/balloob/home-assistant-polymer/blob/master/src/cards/state-card-content.js). + 4. Add `` to [`state-card-content.html`](https://github.com/balloob/home-assistant-polymer/blob/master/src/cards/state-card-content.html). # {% linkable_title More info screens for custom types %} -When you click on a card, the more info dialog will open for that card. This will allow you to see more information and more options to control that entity. +Whenever the user taps or clicks on one of the cards, a more info dialog will show. The header of this dialog will be the state card, followed by the history of this entity for the last 24 hours. Below this the more info component is rendered for that entity. The more info component can show more information or allow more ways of control. -

    - - The more info dialog for a light allows us to control the color and the brightness. +

    + + The more info dialog for a light allows the user to control the color and the brightness.

    -To add your own more info dialog, follow the following steps: +The instructions to add a more info dialog are very similar to adding a new card type. This example will add a new more info component for the domain `camera`: +_(All files in this example link to their source-code)_ - 1. Adjust the moreInfoType property of the State class in [home-assistant-api.html](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/home-assistant-api.html) to return your new more info type when appropriate. - 2. Create a new component following the naming convention more-info-CARDTYPE.html in [/more-infos/](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/more-infos/). - 3. Import your new component in [/more-infos/more-info-content.html](https://github.com/balloob/home-assistant/blob/master/homeassistant/components/http/www_static/polymer/more-infos/more-info-content.html). + 1. Add `'camera'` to the array `DOMAINS_WITH_MORE_INFO` in the file [`util/state-more-info-type.js`](https://github.com/balloob/home-assistant-polymer/blob/master/src/util/state-more-info-type.js#L1). + 2. Create the files `more-info-camera.html` and `more-info-camera.js` in the folder [`/more-infos`](https://github.com/balloob/home-assistant-polymer/tree/master/src/more-infos). + 3. Add `require('./more-info-camera')` to [`more-info-content.js`](https://github.com/balloob/home-assistant-polymer/blob/master/src/more-infos/more-info-content.js) + 4. Add `` to [`more-info-content.html`](https://github.com/balloob/home-assistant-polymer/blob/master/src/more-infos/more-info-content.html) diff --git a/source/getting-started/android.markdown b/source/getting-started/android.markdown index 6338899e541..a1578265a2f 100644 --- a/source/getting-started/android.markdown +++ b/source/getting-started/android.markdown @@ -21,4 +21,4 @@ Home Assistant is not available on the Play Store. Instead, Home Assistant lever

    -Some internet service providers will only offer dynamic IPs. This can cause you to be unable to access Home Assistant while being remote. You can solve this by using a free Dynamic DNS service like [No-IP](http://www.noip.com/). +Some internet service providers will only offer dynamic IPs. This can cause you to be unable to access Home Assistant while being remote. You can solve this by using a free Dynamic DNS service like [DuckDNS](https://www.duckdns.org/). diff --git a/source/getting-started/index.markdown b/source/getting-started/index.markdown index d230dd379cb..582e9ffa44c 100644 --- a/source/getting-started/index.markdown +++ b/source/getting-started/index.markdown @@ -18,14 +18,79 @@ footer: true
    +

    Preparation

    + +
    + + + + + + + + +
    Installing and running Home Assistant on your local machine is easy. Make sure you have Python 3.4 and git installed and execute the following code in a console: + +
    + +
    +

    The preparation of a Fedora 22 host will only take a couple of minutes. First install Python 3.4, git and the other needed packages out of the Fedora Package Collection. This ensure that you receive updates in the future.

    + +

    +It's assumed that your user has an entry in the sudoers file. Otherwise, run the commands which needs more privileges as root. +

    + +```bash +sudo dnf -y install python3 python3-devel git gcc +``` + +
    + +
    + +

    CentOS is providing longtime support and often not shipping the latest release of a software component. To run, Python 3.x on CentOS Software Collections needs to be activated.

    + +
    Step 1. Install the tools for the Software Collection
    + +```bash +sudo yum -y install scl-utils +``` + +
    Step 2. Make the repository available.
    + +```bash +sudo yum -y install https://www.softwarecollections.org/en/scls/rhscl/rh-python34/epel-7-x86_64/download/rhscl-rh-python34-epel-7-x86_64.noarch.rpm +``` + +
    Step 3. Install Python 3.x
    + +```bash +sudo yum -y install rh-python34 +``` + +
    Step 4. Start using software collections:
    + +```bash +scl enable rh-python34 bash +``` + +
    + +
    + +
    + + +

    Installation

    +

    ```bash git clone --recursive https://github.com/balloob/home-assistant.git python3 -m venv home-assistant cd home-assistant -python3 -m pip install -r requirements.txt +source bin/activate python3 -m homeassistant --open-ui ```

    @@ -34,10 +99,25 @@ python3 -m homeassistant --open-ui
  • Download Home Assistant
  • Setup an isolated environment
  • Navigate to downloaded files
    • -
  • Install the dependencies
    • +
  • Activate the isolated environment (on Windows, run Scripts/activate.bat)
  • Launch Home Assistant and serve web interface on http://localhost:8123
    • -

    If you run into any issues, please see the troubleshooting page.

    +
    + + +

    Post-Installation

    + +
    + + + + + + + + +
    +

    There is nothing else to do. If you run into any issues, please see the troubleshooting page.

    You can run Home Assistant in demo mode by appending --demo-mode to line 5. @@ -47,8 +127,92 @@ python3 -m homeassistant --open-ui If you want to update to the latest version in the future, run: scripts/update.

    + +
    + +
    +

    By default, the access to port 8123 is not allowed. If you want to allow other hosts in your local network access, open port 8123.

    + +```bash +sudo firewall-cmd --permanent --add-port=8123/tcp +sudo firewall-cmd --reload +``` +

    Home Assistant will serve its web interface on http://[IP address of the host]:8123.

    + +

    If you want that Home Assistant is lauched automatically, an extra step is needed to setup systemd. You need a service file to control Home Assistant with systemd. The WorkingDirectory and the PYTHONPATH must point to your clone git repository.

    + +```bash +su -c 'cat <> /lib/systemd/system/home-assistant.service +[Unit] +Description=Home Assistant +After=network.target + +[Service] +Type=simple +WorkingDirectory=/home/fab/home-assistant/ +Environment="PYTHONPATH=/home/fab/home-assistant/" +ExecStart=/usr/bin/python3.4 -m homeassistant + +[Install] +WantedBy=multi-user.target +EOF' +``` + +

    You need to reload systemd to make the daemon aware of the new configuration. Enable and launch Home Assistant after that.

    + +```bash +sudo systemctl --system daemon-reload +sudo systemctl enable home-assistant +sudo systemctl start home-assistant +``` + +

    If everything went well, sudo systemctl start home-assistant should give you a positive feedback.

    + +```bash +$ sudo systemctl status home-assistant -l +● home-assistant.service - Home Assistant + Loaded: loaded (/usr/lib/systemd/system/home-assistant.service; disabled; vendor preset: disabled) + Active: active (running) since Thu 2015-06-25 23:38:37 CEST; 3min 13s ago + Main PID: 8557 (python3.4) + CGroup: /system.slice/home-assistant.service + └─8557 /usr/bin/python3.4 -m homeassistant +[...] +``` + +

    To get Home Assistant's logging output, simple use journalctl.

    + +```bash +sudo journalctl -f -u home-assistant +``` + +

    + If you want to update to the latest version in the future, run: scripts/update and restart Home Assistant. +

    + + +

    +Those instructions were written for Fedora 22 Server and Workstation. They may work for Cloud flavor as well but this was not tested. +

    + + +
    + +
    + +

    Coming soon...

    + + +
    +
    + +
    + + +
    + +

    Installation with Docker is straightforward. Adjust the following command so that /path/to/your/config/ points at the folder where you want to store your config and run it:

    @@ -64,6 +228,7 @@ When using boot2docker on OS X you are unable to map the local time to your Dock
    +

    Home Assistant uses Python 3.4. This makes installation on a Raspberry Pi a bit more difficult as it is not available in the package repository. Please follow the following instructions to get it up and running.

    @@ -79,7 +244,7 @@ curl -L https://raw.githubusercontent.com/yyuu/pyenv-installer/master/bin/pyenv- ```bash nano ~/.bashrc ``` - +

    Then add these lines to the end of the file and save:

    ``` export PATH="$HOME/.pyenv/bin:$PATH" @@ -87,7 +252,7 @@ eval "$(pyenv init -)" eval "$(pyenv virtualenv-init -)" ``` -

    Step 2. Install requirements

    +
    Step 2. Install requirements
    ```bash sudo apt-get install python3-dev @@ -122,11 +287,6 @@ cd home-assistant pyenv local homeassistant ``` -

    Step 6. Finish the install

    -```bash -python3 -m pip install -r requirements.txt -``` -

    Step 7. Start it up

    ```bash python3 -m homeassistant @@ -143,3 +303,4 @@ python3 -m homeassistant
    ###[Next step: configuring Home Assistant »](/getting-started/configuration.html) + diff --git a/source/getting-started/troubleshooting.markdown b/source/getting-started/troubleshooting.markdown index e3f967c4e46..6590e7f9bb9 100644 --- a/source/getting-started/troubleshooting.markdown +++ b/source/getting-started/troubleshooting.markdown @@ -11,25 +11,25 @@ footer: true It can happen that you run into trouble while installing Home Assistant. This page is here to help you figure out the most common problems. -python3: command not found -========================== +**python3: command not found**
    Check if Python 3.4 is installed by running `python3 --version`. If it is not installed, [download it here](https://www.python.org/getit/). -No module named pip -=================== -Pip should come bundled with the latest Python 3 but is ommitted by some distributions. If you are unable to run `python3 -m pip --version` you can install pip by [downloading the installer](https://bootstrap.pypa.io/get-pip.py) and run it with Python 3: `python3 get-pip.py`. +**No module named pip**
    +[Pip](https://pip.pypa.io/en/stable/) should come bundled with the latest Python 3 but is ommitted by some distributions. If you are unable to run `python3 -m pip --version` you can install `pip` by [downloading the installer](https://bootstrap.pypa.io/get-pip.py) and run it with Python 3: `python3 get-pip.py`. -git: command not found -====================== +**git: command not found**
    Check if Git is installed by running `git --version`. If you are unable to run this command you can install it by following [these instructions](http://git-scm.com/downloads). -Home Assistant Failing to Launch -================================ -When you are on Linux, it can happen that the requirements fail to install. If this is the case you can fix this by installing the Python 3 development package. For Debian/Ubuntu this can be done by running `apt-get install python3-dev`. +**No module named 'pytz'**
    +There is a problem with installing dependencies on the fly. Install the dependencies manually in advance. -Ubuntu 14.04: ... returned non-zero exit status -=============================================== -There is a known issue with installing on Ubuntu 14.04 and possibly many other newer Debian based distributions. The venv Python 3.4 package that has been bundled in the apt-get repository are known to be broken. This has been documented [in this bug report](https://bugs.launchpad.net/ubuntu/+source/python3.4/+bug/1290847). If you are encountering an error that looks like the following while creating the virtual environment, you are experiencing this bug. +```bash +python3 -m pip install --upgrade pip +python3 -m pip install --upgrade -r requirements.txt +``` + +**Ubuntu 14.04: ... returned non-zero exit status**
    +There is a known issue with installing on Ubuntu 14.04 and possibly many other newer Debian based distributions. The `venv` Python 3.4 package that has been bundled in the apt-get repository are known to be broken. This has been documented [in this bug report](https://bugs.launchpad.net/ubuntu/+source/python3.4/+bug/1290847). If you are encountering an error that looks like the following while creating the virtual environment, you are experiencing this bug. ```bash Error: Command '['home-assistant/bin/python3.4', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status @@ -44,4 +44,8 @@ sudo python3 install_ensurepip.py rm install_ensurepip.py ``` -After these commands have been successfully executed, the venv package will be fixed system-wide. +After these commands have been successfully executed, the `venv` package will be fixed system-wide. + +**No access to the frontend**
    +In newer Linux distributions (at least Fedora 22/CentOS 7) the access to a host are very limited. This means that you can't access the Home Assistant Frontend that is running on a host in your network. Check the Post-installation section on the [Getting started]({{site_root}}/getting-started/index.html) page and follow the instruction that match your distribution to allow access to port 8123. + diff --git a/source/help/help.markdown b/source/help/index.markdown similarity index 100% rename from source/help/help.markdown rename to source/help/index.markdown diff --git a/source/images/frontend/frontend-cards.png b/source/images/frontend/frontend-cards.png new file mode 100644 index 00000000000..cca6cdd7078 Binary files /dev/null and b/source/images/frontend/frontend-cards.png differ diff --git a/source/images/frontend/frontend-more-info-light.png b/source/images/frontend/frontend-more-info-light.png new file mode 100644 index 00000000000..9036a92f7c6 Binary files /dev/null and b/source/images/frontend/frontend-more-info-light.png differ diff --git a/source/images/frontend/polymer-build-architecture.png b/source/images/frontend/polymer-build-architecture.png new file mode 100644 index 00000000000..000e8b5d461 Binary files /dev/null and b/source/images/frontend/polymer-build-architecture.png differ diff --git a/source/images/supported_brands/asus.png b/source/images/supported_brands/asus.png new file mode 100644 index 00000000000..8aa3e48ac7b Binary files /dev/null and b/source/images/supported_brands/asus.png differ diff --git a/source/images/supported_brands/camera-web.png b/source/images/supported_brands/camera-web.png new file mode 100644 index 00000000000..cc67fa86c67 Binary files /dev/null and b/source/images/supported_brands/camera-web.png differ diff --git a/source/images/supported_brands/edimax.png b/source/images/supported_brands/edimax.png new file mode 100644 index 00000000000..7a4d88f06a6 Binary files /dev/null and b/source/images/supported_brands/edimax.png differ diff --git a/source/images/supported_brands/efergy.png b/source/images/supported_brands/efergy.png new file mode 100644 index 00000000000..4d1c1673cde Binary files /dev/null and b/source/images/supported_brands/efergy.png differ diff --git a/source/images/supported_brands/kodi.png b/source/images/supported_brands/kodi.png index fe537e1dc3f..dfc527269a5 100644 Binary files a/source/images/supported_brands/kodi.png and b/source/images/supported_brands/kodi.png differ diff --git a/source/images/supported_brands/logitech.png b/source/images/supported_brands/logitech.png new file mode 100644 index 00000000000..1992dad2f9e Binary files /dev/null and b/source/images/supported_brands/logitech.png differ diff --git a/source/images/supported_brands/mqtt.png b/source/images/supported_brands/mqtt.png new file mode 100644 index 00000000000..1e649faf345 Binary files /dev/null and b/source/images/supported_brands/mqtt.png differ diff --git a/source/images/supported_brands/nest_thermostat.png b/source/images/supported_brands/nest_thermostat.png index 8ce871f6bee..8b1b8ff443f 100644 Binary files a/source/images/supported_brands/nest_thermostat.png and b/source/images/supported_brands/nest_thermostat.png differ diff --git a/source/images/supported_brands/preferences-system-sharing.png b/source/images/supported_brands/preferences-system-sharing.png new file mode 100644 index 00000000000..966181e2635 Binary files /dev/null and b/source/images/supported_brands/preferences-system-sharing.png differ diff --git a/source/images/supported_brands/raspberry-pi.png b/source/images/supported_brands/raspberry-pi.png new file mode 100644 index 00000000000..36439abc0d7 Binary files /dev/null and b/source/images/supported_brands/raspberry-pi.png differ diff --git a/source/images/supported_brands/slack.png b/source/images/supported_brands/slack.png new file mode 100644 index 00000000000..07654fbc9f8 Binary files /dev/null and b/source/images/supported_brands/slack.png differ diff --git a/source/images/supported_brands/transmission.png b/source/images/supported_brands/transmission.png index 06072273350..7981018ede9 100644 Binary files a/source/images/supported_brands/transmission.png and b/source/images/supported_brands/transmission.png differ diff --git a/source/images/supported_brands/verisure.png b/source/images/supported_brands/verisure.png new file mode 100644 index 00000000000..017faf31c41 Binary files /dev/null and b/source/images/supported_brands/verisure.png differ