:app rss

A good RSS reader that Google can’t shut down

1. Description

Read RSS feeds in the comfort of Doom Emacs.

1.1. Maintainers

This module has no dedicated maintainers. Become a maintainer?

1.2. Module flags

+org
Allows the use of org to configure your RSS feeds, in {org-directory}/elfeed.org.

1.4. Hacks

  • By default elfeed-search-filter is set to @2-weeks-ago and makes the last 2 weeks of entries visible. This needs to be set after elfeed has loaded like so in your config.el:

    # ⎘
    (after! elfeed
  (setq elfeed-search-filter "@1-month-ago +unread"))

2. Prerequisites

This module has no external prerequisites.

3. TODO Usage

This module’s usage documentation is incomplete. Complete it?

There is no keybinding for elfeed-update yet, so it must be invoked with M-x elfeed-update.

4. Configuration

4.1. Without +org

When you don’t want to use org mode to manage your elfeed feeds you can put your subscriptions to personal config.el file, ex:

# ⎘
(setq elfeed-feeds
      '("https://this-week-in-rust.org/rss.xml"
	"http://feeds.bbci.co.uk/news/rss.xml"))

4.2. With +org

When using +org flag then configuration is easier. You can use org-mode to configure feeds to follow.

# ⎘
* root :elfeed:
** Programming :programming:
*** [[https://this-week-in-rust.org/rss.xml][This Week in Rust]] :rust:
** News :news:
*** Top news :tops:
**** http://feeds.bbci.co.uk/news/rss.xml
  • Root of elfeed-org needs to have :elfeed: tag. This is where elfeed-org starts to read.
  • You can have subheaders as in example :programming:, and elfeed-org applies that tag to all subheader feeds, in example it adds it to This Week in Rust.
  • You can “name” feeds as you please with org-mode org-insert-link (C-c C-l) and put name as you want into description.
  • If you don’t want to use org-directory/elfeed.org file you can specify it with (setq rmh-elfeed-org-files '("path/to/your/elfeed/file.org))

4.3. Keybindings

  • General

    Key Mode Description
    S-RET Elfeed-search-mode Open link into browser
    RET Elfeed-search-mode Open item
    s Elfeed-search-mode Filter
    C-j Elfeed-show-mode Move to next item
    C-k Elfeed-show-mode Move to previous item

  • If :editor evil +everywhere

    Key Description
    q elfeed-kill-buffer
    r elfeed-search-update–force
    g c elfeed-search-update–force

4.4. News filtering

  • Time filtering
    • @2-days-ago Past two days
    • @2-weeks-ago Past two weeks
    • @2-years-ago Past two years
    • @2020-06-19 To show specific day
    • @2020-06-19--2020-03-10 Span of time
  • Tag filtering
    • Include +news
    • Exclude -rust
    • Both +news -rust
  • String filtering, this is case insensitive
    • Include
      • DOOM
      • Linu[sx] Search for both Linus and Linux
    • Exclude !something

4.5. Automatically updating feed when opening elfeed

# ⎘
;; add to $DOOMDIR/config.el
(add-hook! 'elfeed-search-mode-hook #'elfeed-update)

5. Troubleshooting

There are no known problems with this module. Report one?

6. TODO Appendix

This module has no appendix yet. Write one?