This module allows to create and change entries in an Org-mode file triggered by items in an RSS feed. The basic functionality is geared toward simply adding new items found in a feed as outline nodes to an Org file. Using hooks, arbitrary actions can be triggered for new or changed items.
This module is configured through a single variable,
Here is an example, using a notes/tasks feed from reQall.com.
(setq org-feed-alist '(("ReQall" "http://www.reqall.com/user/feeds/rss/a1b2c3....." "~/org/feeds.org" "ReQall Entries")
With this setup, the command
M-x org-feed-update-all will
collect new entries in the feed at the given URL and create
entries as subheadings under the "ReQall Entries" heading in the
file "~/org-feeds.org". Each feed needs to have its own heading.
Besides these standard elements that need to be specified for each
feed,, keyword-value pairs can set additional options. For example,
to de-select transitional entries with a title containing reQall is
typing what you said you could use the
(setq org-feed-alist '(("ReQall" "http://www.reqall.com/user/feeds/rss/a1b2c3....." "~/org/feeds.org" "ReQall Entries" :filter my-reqall-filter)))
(defun my-reqall-filter (e) (if (string-match "reQall is typing what you said" (plist-get e :title)) nil e))
See the docstring for
org-feed-alist for more details.
Since Org allows you to delete, archive, or move outline nodes, org-feed.el needs to keep track of which feed items have been handled before, so that they will not be handled again. For this, org-feed.el stores information in a special drawer, FEEDSTATUS, under the heading that received the input of the feed. You should add FEEDSTATUS to your list of drawers in the files that receive feed input:
,#+DRAWERS: PROPERTIES LOGBOOK FEEDSTATUS
Alist specifying RSS feeds that should create inputs for Org. Each entry in this list specified an RSS feed tat should be queried to create inbox items in Org. Each entry is a list with the following items:
Additional arguments can be given using keyword-value pairs. Many of
these specify functions that receive one or a list of "entries" as
their single argument. An entry is a property list that describes a
feed item. The property list has properties for each field in the
item, for example
:title for the
<title> field and
the publication date. In addition, it contains the following
Here are the keyword-value elements that can be configured
org-feed.el is based on ideas by Brad Bozarth who implemented a similar mechanism using shell and awk scripts.