dweet.io


The dweet integration makes it possible to transfer details collected with Home Assistant to Dweet.io and visualize them with freeboard.io. Keep in mind that your information will be public!

The publishing interval is limited to 1 second. This means that it's possible to miss fast changes.

There is currently support for the following device types within Home Assistant:

Configuration

To use the dweet integration in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
dweet:
  name: YOUR_UNIQUE_IDENTIFIER
  whitelist:
    - input_number.brightness
    - input_boolean.notify_home
    - sensor.weather_temperature
    - sensor.cpu

Configuration Variables

name string Required

A unique identifier for your Home Assistant instance.

whitelist list Required

List of entity IDs you want to publish

Sensor

The dweet sensor platform allows you to get details from your devices which are publishing their values to Dweet.io.

Configuration

To use Dweet.io sensors in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
  - platform: dweet
    device: THING_NAME
    value_template: "{{ value_json.VARIABLE }}"

Configuration Variables

device string Required

Identification of the device (also known as thing).

value_template template Required

The variable to extract a value from the content.

name string (Optional, default: Dweet.io Sensor)

Let you overwrite the name of the device in the frontend.

unit_of_measurement string (Optional)

Defines the unit of measurement of the sensor, if any.

Full configuration sample

A full configuration entry could look like the sample below.

# Example configuration.yaml entry
sensor:
  - platform: dweet
    name: Temperature
    device: THING_NAME
    value_template: "{{ value_json.VARIABLE }}"
    unit_of_measurement: "°C"

Interacting with Dweet.io

You can easily send dweets from the command-line to test your sensor with curl.

curl -H 'Content-Type: application/json' -d '{"temperature": 40, "humidity": 65}' https://dweet.io/dweet/for/ha-sensor

will give you a response like the one below:

{"this":"succeeded","by":"dweeting","the":"dweet","with":{"thing":"ha-sensor","created":"2015-12-10T09:43:31.133Z","content":{"temperature":40,"humidity":65}}}

The dweepy module gives you another option to work with Dweet.io.

Send a dweet.

$ python3
>>> import dweepy
>>> dweepy.dweet_for('ha-sensor', {'temperature': '23', 'humiditiy':'81'})
{'thing': 'ha-sensor', 'created': '2015-12-10T09:46:08.559Z', 'content': {'humiditiy': 81, 'temperature': 23}}

Receive the latest dweet.

>>> dweepy.get_latest_dweet_for('ha-sensor')
[{'thing': 'ha-sensor'', 'created': '2015-12-10T09:43:31.133Z', 'content': {'humidity': 65, 'temperature': 40}}]