From 005ab6f3666ad7384c4169fcd912467894dcd3cc Mon Sep 17 00:00:00 2001 From: Joakim af Sandeberg Date: Sat, 22 Apr 2017 14:04:09 +0200 Subject: [PATCH] Create sensor.pushbullet.markdown (#2461) * Create sensor.pushbullet.markdown Reopening of #2115 **Description:** Added doc for the new pushbullet sensor **Pull request in [home-assistant](https://github.com/home-assistant/home-assistant) (if applicable):** home-assistant/home-assistant#7182 * Updated date * Add ha_release and some minor format changes --- source/_components/sensor.pushbullet.markdown | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 source/_components/sensor.pushbullet.markdown diff --git a/source/_components/sensor.pushbullet.markdown b/source/_components/sensor.pushbullet.markdown new file mode 100644 index 00000000000..4b60f5cf5fb --- /dev/null +++ b/source/_components/sensor.pushbullet.markdown @@ -0,0 +1,48 @@ +--- +layout: page +title: "Pushbullet Mirrors" +description: "Instructions how to read user pushes in Home Assitant" +date: 2017-04-20 16:44 +sidebar: true +comments: false +sharing: true +footer: true +logo: pushbullet.png +ha_category: Sensor +ha_release: 0.44 +--- + +The `pushbullet` sensor platform reads messages from [Pushbullet](https://www.pushbullet.com/), a free service to send information between your phones, browsers, and friends. +This sensor platform provide sensors that show the properties of the latest recevied pushbullet notification mirror. + +Notification Mirroring allows users to see their Android device's notifications on their computer. It must be first enabled in the app and is currently only available on the Android platform. For more information, please see [this announcement](https://blog.pushbullet.com/2013/11/12/real-time-notification-mirroring-from-android-to-your-computer/) on the Pushbullet Blog + +To enable the Pushbullet sensor in your installation, add the following to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: pushbullet + api_key: YOUR_API_KEY + monitored_conditions: + - body +``` + +Configuration variables: + +- **api_key** (*Required*): Enter the API key for Pushbullet. Go to [https://www.pushbullet.com/#settings/account](https://www.pushbullet.com/#settings/account) to retrieve your API key/access token. + +- **monitored_conditions** array (*Optional*): Properties of the push to monitor. Defaults to `body` and `title`. + - **application_name**: The application sending the push. + - **body**: Body of the message. + - **notification_id**: ID of the notification. + - **notification_tag**: Tag (if the application sending supports it). + - **package_name**: Name of the sender's package. + - **receiver_email**: The email of the push's target. + - **sender_email**: The sender of the push. + - **source_device_iden**: ID of the sender's device. + - **title**: Title of the push. + - **type**: Type of push. + + +All properties will be displayed as attributes. The properties array are just for logging the sensor readings for multiple properties.