spacemacs/layers/+tools/elfeed

• Elfeed contribution layer for Spacemacs
• Description
• Install
  • Layer
  • Setup feeds
  • Server
  • Importing Feeds
• Key Bindings
• Troubleshooting
  • Queue timeout exceeded

Elfeed contribution layer for Spacemacs

logo

Description

This layer enables Elfeed, a web feeds client which supports both Atom and RSS feeds. It'll optionally enable supporting packages, such as elfeed-web and elfeed-org.

Install

Layer

To use this layer, add it to your ~/.spacemacs

(setq-default dotspacemacs-configuration-layers '(elfeed))

By default, elfeed stores its database under ~/.elfeed.

Setup feeds

To explicitly setup the list of feeds, set the value of elfeed-feeds variable in your .spacemacs file.

(elfeed :variables
   elfeed-feeds '(("http://nullprogram.com/feed/" blog emacs)
                  "http://www.50ply.com/atom.xml"  ; no autotagging
                  ("http://nedroid.com/feed/" webcomic))))

Check documentation for elfeed-feeds for more information about this variable (SPC h d v elfeed-feeds RET).

But you might prefer to use elfeed-org package and store all your feeds in separate org file. Then you have to specify it's path.

(elfeed :variables
   rmh-elfeed-org-files '("~/.emacs.d/private/elfeed.org"))

Checkout elfeed-org documentation to see the format of that file.

Server

Elfeed comes with simple web interface. You can manually start it by calling elfeed-web-start or by setting elfeed-web-enabled-on-emacs-startup to t, so it starts automatically on Emacs startup.

(elfeed :variables
   elfeed-web-enabled-on-emacs-startup t)

By default web interface is available on localhost:8080/elfeed. You can change the default port by changing value of httpd-port.

Importing Feeds

Feeds can be specified in configuration variable, or interactively imported from OPML, running SPC-: elfeed-load-opml, or afo.

When imported interactively, feedlist will be saved in your customization file.

Key Bindings

Key Binding	Description
SPC a f	start elfeed

Use SPC ? to discover major-mode key bindings.

Key Binding	Description
q	quit main window, or item view buffer.
c	compact feed db
o	looad OPML
w	start web server
W	stop web server

Troubleshooting

Queue timeout exceeded

If you are getting "Queue timeout exceeded" errors, just increase url-queue-timeout value.

(elfeed :variables
   url-queue-timeout 30)