macOSLinux

Where Does sfeed Store Feeds and Config?

sfeed keeps a shell-evaluated sfeedrc plus per-feed TSV files under ~/.sfeed, with OPML import/export built in.

Last updated

sfeed centers on ~/.sfeed/sfeedrc: a shell script defining feeds() that sfeed_update evaluates, merging items into TSV files under ~/.sfeed/feeds/. Readers like sfeed_plain or sfeed_curses then format those files.

That pipeline design keeps every stage inspectable. Fetching, merging and display are separate commands over plain files, so debugging means reading TSV, not spelunking a database.

Where sfeed stores this, by platform

macOS
~/.sfeed/sfeedrc

Feed definitions as shell. sfeed_update merges into feeds/ TSVs; format with sfeed_plain, sfeed_html or sfeed_curses plus dmenu.

Linux
~/.sfeed/sfeedrc

Same layout. maxjobs parallelizes fetches; an optional path argument to sfeed_update selects an alternate rc file.

Frequently asked questions

How do I add feeds to sfeed?

Copy sfeedrc.example to ~/.sfeed/sfeedrc and list feeds as shell functions. The file executes as shell, so loops and variables generate feeds programmatically.

Can I migrate subscriptions from another reader?

Run sfeed_opml_import < file.opml > ~/.sfeed/sfeedrc (and sfeed_opml_export to go back). Newsboat users pipe newsboat -e straight into the importer.

Notice an outdated path? Let us know.