3.3 KiB
Elfeed contribution layer for Spacemacs
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)