Elfeed is an extensible web feed reader for Emacs, supporting both Atom and RSS. It requires Emacs 24 and is available for download from MELPA. Elfeed was inspired by notmuch.
For a longer overview, see Introducing Elfeed, an Emacs Web Feed Reader.
The database format is now stable, but there may still be an update someday that requires you to initialize a new database from scratch.
Elfeed is broken into a multiple source files, so if you manually
install it you will need to add the Elfeed package directory to your
load-path
. If installed via ELPA, this will be done automatically.
It is recommended that you make a global binding for elfeed
.
(global-set-key (kbd "C-x w") 'elfeed)
Running the interactive function elfeed
will pop up the
*elfeed-search*
buffer, which will display feed items.
- g: refresh view of the feed listing
- G: fetch feed updates from the servers
- s: update the search filter (see tags)
This buffer will be empty until you add your feeds to the
elfeed-feeds
list and initiate an update with M-x elfeed-update
(or G in the Elfeed buffer). This will populate the Elfeed
database with entries.
;; Somewhere in your .emacs file
(setq elfeed-feeds
'("http://nullprogram.com/feeds/"
"http://www.terminally-incoherent.com/blog/feed/"))
Another option for providing a feel list is with an OPML file. Running
M-x elfeed-load-opml
will fill elfeed-feeds
with feeds listed in
an OPML file. When elfeed-load-opml
is called interactively, it will
automatically save the feedlist to your customization file, so you
will only need to do this once.
If there are a lot of feeds, the initial update will take noticeably
longer than normal operation because of the large amount of
information being written the database. Future updates will only need
to write new or changed data. If updating feeds slows down Emacs too
much on your computer, reduce the value of elfeed-max-connections
(the number of feeds to process at one time).
From the search buffer there are a number of ways to interact with entries. Entries are selected by placing the point over an entry. Multiple entries are selected at once by using an active region.
- RET: view selected entry in a buffer
- b: open selected entries in your browser (
browse-url
) - y: copy selected entries URL to the clipboard
- r: mark selected entries as read
- u: mark selected entries as unread
- +: add a specific tag to selected entries
- -: remove a specific tag from selected entries
Elfeed maintains a list of arbitrary tags -- symbols attached to an
entry. The tag unread
is treated specially by default, with unread
entries appearing in bold.
To make tags useful, the Elfeed entry listing buffer can be filtered
by tags. Use elfeed-search-set-filter
(or s) to update
the filter.
Any component of the search string beginning with a +
or
a -
is treated like a tag. +
means the tag is required, -
means
the tag must not be present.
A component beginning with a @
indicates an age. Entries older than
this age are filtered out. The age description accepts plain English,
but cannot have spaces, so use dashes. For example, "@2-years-old"
or "@3-days-ago"
. The database is date-oriented, so filters that
include an age restriction are significantly more efficient.
Consider adding something like @1-week-old
to your default
elfeed-search-filter
.
All other components are treated as a regular expression.
Here are some example filters.
+unread
Only show unread entries. This is the default filter.
linu[xs] @1-year-old
Only show entries about Linux or Linus from the last year.
-unread +youtube
Only show previously-read entries tagged as youtube
.
The last example assumes you've tagged posts with youtube
. You
probably want to do this sort of thing automatically, which can be
done with the elfeed-new-entry-hook
. Functions in this hook are
called with new entries, allowing them to be manipulated, such as
adding tags.
;; Mark all YouTube entries
(add-hook 'elfeed-new-entry-hook
(elfeed-make-tagger :feed-url "youtube\\.com"
:add '(video youtube)))
Avoiding tagging old entries as unread
:
;; Entries older than 2 weeks are marked as read
(add-hook 'elfeed-new-entry-hook
(elfeed-make-tagger :before "2 weeks ago"
:remove 'unread))
Or building your own subset feeds:
(add-hook 'elfeed-new-entry-hook
(elfeed-make-tagger :feed-url "example\\.com"
:entry-title '(not "something interesting")
:add 'junk
:remove 'unread))
Elfeed includes a web interface for remote network access. It's a
single-page web application that follows the database live as new
entries arrive. It's packaged separately on MELPA as elfeed-web
. To
fire it up, run M-x elfeed-web-start
and visit
http://localhost:8080/elfeed/ (check your httpd-port
) with a
browser. See the elfeed-web.el
header for endpoint documentation if
you'd like to access the Elfeed database through the web API.
It's a bit rough at the moment -- no keyboard shortcuts, read-only, no authentication, and a narrow entry viewer -- but I'm looking to improve it in the future. This will be Elfeed's "mobile" interface.
I only use Elfeed on Linux right now, but I've also tested it on Windows. Unfortunately the Windows port of Emacs is a bit too unstable for parallel feed downloads, not to mention the tiny, hard-coded, 512 open descriptor limitation, so it limits itself to one feed at a time on this platform. However, even on Linux Elfeed occasionally triggers segmentation faults in Emacs. If I am able, I intend to isolate these segfaults and report them to the Emacs developers.
The GNU-provided W32 build of Emacs doesn't include any of the libraries needed to actually view entries within Emacs, but you can still see the entry listing and visit entries in your browser. So on Windows you'll either have to track down and install the missing DLLs, or use ntemacs, which includes these libraries.
Elfeed is to the point where it can serve 100% of my own web feed needs. My personal selection of about 140 feeds has been acting as my test case as I optimize and add features.
Some things I still might want to add:
- Database synchronization between computers
As far as I know, outside of Elfeed there does not exist an extensible, text-file configured, power-user web feed client that can handle a reasonable number of feeds. The existing clients I've tried are missing some important capability that limits its usefulness to me.