Configure the Elfeed RSS reader with an Orgmode file
Maintaining tags for all my rss feeds is cumbersome using the regular flat list where there is no hierarchy and tag names are duplicated a lot. For example this is how elfeed users typically configure their subscriptions.
(defvar elfeed-feeds-alist '(("http://threesixty360.wordpress.com/feed/" blog math) ("http://www.50ply.com/atom.xml" blog dev) ("http://blog.cryptographyengineering.com/feeds/posts/default" blog) ("http://abstrusegoose.com/feed.xml" comic) ("http://accidental-art.tumblr.com/rss" image math) ("http://english.bouletcorp.com/feed/" comic) ("http://curiousprogrammer.wordpress.com/feed/" blog dev) ("http://feeds.feedburner.com/amazingsuperpowers" comic) ("http://amitp.blogspot.com/feeds/posts/default" blog dev) ("http://pages.cs.wisc.edu/~psilord/blog/rssfeed.rss" blog) ("http://www.anticscomic.com/?feed=rss2" comic) ("http://feeds.feedburner.com/blogspot/TPQSS" blog dev)))
If you want to add a custom title to a feed, that is even more cumbersome...
Org-mode makes the book keeping of tags and feeds much easier. Tags get inherited from parent headlines so there is no need to specify tags for each and every feed.
* Blogs :elfeed: ** entry-title: \(linux\|linus\|ubuntu\|kde\|gnome\) :linux: ** http://git-annex.branchable.com/design/assistant/blog/index.rss :mustread: ** http://feeds.feedburner.com/InformationIsBeautiful ** [[http://orgmode.org][Org Mode Links supported as well]] ** Software Development :dev: *** Emacs :emacs:mustread: **** http://www.terminally-incoherent.com/blog/feed **** http://nullprogram.com/feed **** entry-title: \(emacs\|org-mode\) **** http://planet.emacsen.org/atom.xml **** [[toobnix:154][EmacsConf]] *** Web Development :web: **** http://planet.phpunit.de/atom.xml **** http://feeds.feedburner.com/symfony/blog **** http://feeds.feedburner.com/qooxdoo/blog/content *** Eclipse :eclipse: **** http://blog.eclipse-tips.com/feeds/posts/default?alt=rss **** http://ed-merks.blogspot.com/feeds/posts/default A description of a feed can be written under any headline. The text will be ignored by elfeed. **** http://feeds.feedburner.com/eclipselive :ignore: **** http://www.fosslc.org/drupal/rss.xml :video: #+link toobnix https://toobnix.org/feeds/videos.xml?videoChannelId=
[[http://orgmode.org][Org Mode Links supported as well]]If you choose to use org-mode links, the link description will be used as the feed's title in Elfeed. This is useful for feeds with long titles.
entry-title: \(emacs\|org-mode\)Tags any blog post with "emacs" or "org-mode" in the title according to it's given and inherited tags (in the example above "emacs", "mustread" and "dev").
http://feeds.feedburner.com/eclipselive :ignore:The "ignore" excludes the feed completely from your checked subscriptions. You can use another name for "ignore" by customizing
rmh-elfeed-org-ignore-tag. These "ignore" tags are set by elfeed-org automatically on feed errors (wrong urls or renamed feeds for example) if
rmh-elfeed-org-auto-ignore-invalid-feedsis set to
elfeed-org-export-opml to export the tree structure of feeds to OPML format to a temporary buffer. This will allow you to make edits before saving it. You will probabably want to do this because most readers don't allow more than 2 levels while elfeed-org has no limit.
elfeed-org-import-opml to import an OPML file to an elfeed-org structured tree.
The Configuration Tree
You can use multiple trees. Those trees can be in same file or spread
across multiple files specified in the list
rmh-elfeed-org-files. Why would I want to use multiple trees? You
can have a tree in a file that you may want to share with your
emacs.d on GitHub and keep your personal feeds in a separate private
In the initial version of this package the tree is identified by
setting the ID property to to the value of
("elfeed" by default) but that property turns out to be special (see
org mode manual)
and I should not have used it. To not break any existing users'
configurations this is still allowed but I recommend to tag the tree
now with the value of
So instead of
* Blogs :PROPERTIES: :ID: elfeed :END:
I recommend to use
* Blogs :elfeed:
A few tips for the org-mode feed configuration:
- The tree should have a tag matching the string specified in the
- Feeds must start with
http, or be in org-mode link format (the URL should still start with
- Tag rules must start with
entry-title:and end with a regular expression.
- A tag rule tags all the posts that match the regular expression in the title
using a "tag hook" with
elfeed-make-tagger. For more info see https://github.com/skeeto/elfeed
- You may add text below the headline with the url to describe the feed or to add notes. They will be ignored.
- Headlines not starting with
entry-title:will be ignored.
Runs on emacs versions specified in
This package needs
org-mode 8.2.7 to run properly if you use the
emacs-24 distribution. The reason that that org-mode version is needed is because
org-mode 8.2.6 - at least in combination with
GNU Emacs 188.8.131.52 - causes the error
(error "recenter'ing a window that does not display current-buffer.").
The minimum version of org-mode that is minimally needed to even run is
org-mode 8.1 as that is the first release that defined the function
org-element-map which is critical for this package.
;; Install through package manager M-x package-install <ENTER> elfeed-org <ENTER>
cd ~/.emacs.d/lisp wget https://github.com/remyhonig/elfeed-org/blob/master/elfeed-org.el
Install the package in Emacs
C-x C-f ~/.emacs.d/lisp/elfeed-org.el <ENTER> M-x package-install-from-buffer <ENTER>
In your initialization script add the following:
;; Load elfeed-org (require 'elfeed-org) ;; Initialize elfeed-org ;; This hooks up elfeed-org to read the configuration when elfeed ;; is started with =M-x elfeed= (elfeed-org) ;; Optionally specify a number of files containing elfeed ;; configuration. If not set then the location below is used. ;; Note: The customize interface is also supported. (setq rmh-elfeed-org-files (list "~/.emacs.d/elfeed.org"))
Feature requests and bug fixes
I appreciate feature requests and code snippets provided to fix things, but I really don't have much spare time nowadays. If you'd like to add a feature or fix a bug, please post a pull requests and I will merge it right away if has a corresponding test and an update of the README if applicable. I just migrated the CI from Travis - which was not functional anymore - to Github Action so this should be a faster process now. And to close off: a big thank you to all PR authors and issue submitters!