Skip to content

Commit

Permalink
RSS feed template documentation (home-assistant#2411)
Browse files Browse the repository at this point in the history
* RSS feed template documentation

* Small fixes

* Change release version

* Update rss_feed_template.markdown

Added missing `the`

* Option 'requires_api_password', default is True
  • Loading branch information
micw authored and balloob committed Apr 25, 2017
1 parent efd24ef commit 1241a5d
Showing 1 changed file with 37 additions and 0 deletions.
37 changes: 37 additions & 0 deletions source/_components/rss_feed_template.markdown
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
layout: page
title: "RSS feed template"
description: "Instructions how to setup an RSS feed for sensor information and other."
date: 2017-04-11 20:42
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Front end
ha_release: 0.43
---

The `rss_feed_template` component can export any information from Home Assistant as static RSS feed. This can be used to display those information on several devices using RSS readers. While native apps for Home Assistant are not widely available, native RSS readers exists for almost any platform.

E.g. on android, the app "Simple RSS Widget" can be used to display temperatures on the home screen.


```yaml
# Example configuration.yml entry
rss_feed_template:
garden:
requires_api_password: False
title: "Garden {{ as_timestamp(now())|timestamp_custom('%H:%m', True) }}"
items:
- title: "Outside temperature"
description: "{% if is_state('sensor.temp_outside','unknown') %}---{% else %}{{states.sensor.temp_outside.state}} °C{% endif %}"
```
Configuration variables:
- **requires_api_password:** (*Optional*): If true and an api password is set, the password must be passed via '?api_password=...' parameter (Default: True)
- **feed_id** (*Required*): The key is used as id of the feed. The feed can be accessed at /api/rss_template/feed_id (example: 'garden')
- **title** (*Optional*): The title of the feed, which is parsed as [template](/topics/templating/).
- **items** (*Required*): A list of feed items
- **items/title** (*Optional*): The title of the item, which is parsed as [template](/topics/templating/).
- **items/description** (*Optional*): The description of the item, which is parsed as [template](/topics/templating/).

0 comments on commit 1241a5d

Please sign in to comment.