mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-05-05 10:38:58 +00:00

Added additional example of feedreader automation to explain how to access data form the feed in the automation.
1.6 KiB
1.6 KiB
layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout | title | description | date | sidebar | comments | sharing | footer | logo | ha_category | ha_release |
---|---|---|---|---|---|---|---|---|---|---|
page | Feedreader | Instructions how to integrate RSS feeds into Home Assistant. | 2016-04-18 22:00 | true | false | true | true | rss.gif | Other | 0.18 |
Add an RSS/Atom feed reader that polls feeds every hour and sends new entries into the event bus.
To use RSS feeds in your installation, add the following to your configuration.yaml
file:
# Example configuration.yaml entry
feedreader:
urls:
- https://home-assistant.io/atom.xml
- https://github.com/blog.atom
Configuration variables:
- urls (Required): List of URLS for your feeds.
Feedreader events can be used out of the box to trigger automation actions, e.g.:
automation:
- alias: Trigger action when new element(s) in RSS feed
trigger:
platform: event
event_type: feedreader
action:
service: script.turn_on
entity_id: script.my_action
automation:
- alias: Send notification of RSS feed title when updated
trigger:
platform: event
event_type: feedreader
action:
service: notify.notify
data_template: "{{ trigger.event.data.title }}"
*Any field under the <entry>
tag in the feed can be used for example tigger.event.data.content
will get the body of the feed entry.
For more advanced use cases, a custom component registering to the feedreader
event type could be used instead:
EVENT_FEEDREADER = "feedreader"
hass.bus.listen(EVENT_FEEDREADER, event_listener)
To get started developing custom components, please refer to the developers documentation