feeds/
rssd 0.3.0 · a daemon that writes a directory
The filesystem
is the API.
rssd turns RSS and Atom feeds into a directory tree of plain XML files. No database, no socket, no client library. If it can read a folder, it is a client.
$ rss feeds --no-color NAME HEALTH ENTRIES LAST POLL TITLE lwn ok 15 2026-10-05 LWN.net rust-blog ok 10 2026-10-05 Rust Blog xkcd ok 4 2026-10-05 xkcd.com $ ls -la store/rust-blog | tail -n +2 drwxr-xr-x. 1 allie allie 50 Oct 4 19:41 . drwxr-xr-x. 1 allie allie 32 Oct 4 19:41 .. drwxr-xr-x. 1 allie allie 2696 Oct 4 19:41 entries -rw-r--r--. 1 allie allie 344 Oct 4 19:41 feed.xml -rw-r--r--. 1 allie allie 251 Oct 4 19:41 status.xml $ ls -l store/rust-blog/entries | tail -n 4 -rw-r--r--. 1 allie allie 8490 Oct 4 19:41 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.r1.xml lrwxrwxrwx. 1 allie allie 55 Oct 4 19:41 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.xml -> 20261001T000000Z-d3cf546b-announcing-rust-1-99-0.r1.xml -rw-r--r--. 1 allie allie 3393 Oct 4 19:41 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.r1.xml lrwxrwxrwx. 1 allie allie 74 Oct 4 19:41 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.xml -> 20261002T000000Z-979c2fbd-demoting-i686-windows-targets-to-std-only.r1.xml
$ xmllint --format store/rust-blog/entries/20260903T000000Z-840ac61d-announcing-rust-1-98-1.xml | cut -c1-110 | head -n 28 <?xml version="1.0" encoding="utf-8"?> <entry xmlns="https://rssd.dev/entry/1" id="sha256:840ac61de3c7dd0bb03a9e1a86da3a154aa349b309ca44081a12d28de60 <source> <link>https://blog.rust-lang.org/2026/09/03/Rust-1.98.1/</link> <feed name="rust-blog" title="Rust Blog">https://blog.rust-lang.org/feed.xml</feed> <guid basis="atom-id">https://blog.rust-lang.org/2026/09/03/Rust-1.98.1/</guid> </source> <title>Announcing Rust 1.98.1</title> <author>The Rust Release Team</author> <published origin="feed">2026-09-03T00:00:00Z</published> <content origin="feed:content" hash="sha256:e46b8520b188c95239ac110d359a03c5e46e19b4a6079d04f903a1f077b9782f <paragraph>The Rust team has published a new point release of Rust, 1.98.1. Rust is a programming language <paragraph>If you have a previous version of Rust installed via rustup, getting Rust 1.98.1 is as easy as: <code>rustup update stable</code> <paragraph>If you don't have it already, you can <link href="https://www.rust-lang.org/install.html">get < <heading level="2"> What's in 1.98.1</heading> <paragraph>Rust 1.98.1 fixes a <link href="https://github.com/rust-lang/rust/issues/161441">miscompilation <paragraph>In Rust 1.98.0, in some circumstances, rustc would incorrectly generate a trait object vtable w <paragraph>If you'd like to help us out by testing future releases, you might consider using the beta (<co <heading level="3"> Contributors to 1.98.1</heading> <paragraph>Many people came together to create Rust 1.98.1. We couldn't have done it without all of you. < </content> </entry>
Captured on 2026-10-04: rssd add for blog.rust-lang.org, xkcd.com and lwn.net, one rssd once, then these commands. Every entry is a symlink to its newest revision. Only the line widths were trimmed, and the pipes that do it are in the commands.
entries/
-r--r--r-- atomic-writes.txt
Every file is written to a temp name, fsynced, then renamed into place. A reader sees the old file or the new one, never a half-written one. Each document is re-parsed with a strict XML parser before the rename, so malformed output cannot reach the tree.
lrwxrwxrwx revisions.txt -> *.r2.xml
Nothing is overwritten. When a publisher edits a post, the new version lands beside the old one as
.r2.xmland a stable symlink is repointed. Follow the symlink for current, or list.rNfor the whole history.-r--r--r-- vocabulary.xml
Publisher HTML is mapped onto a small fixed set of tags:
paragraph,heading,code,link. Wrapper divs, class attributes and tracking junk are gone, and relative URLs are resolved. Every entry has the same shape, whoever wrote it.-r--r--r-- tree-is-truth.txt
Each entry embeds its own ID and content hash, so
rm -rf var/is fully recoverable. The daemon rebuilds what it knows by scanning the tree, and writes nothing.-r--r--r-- rss.readonly
rssis a separate binary fromrssd. It opens no file for writing, anywhere, which is the proof that the output tree is a sufficient API for someone else's program.
reader/
A vim-flavoured terminal reader with three panes: feeds, entries, and the article. It reads the filesystem and nothing else, so the daemon does not need to be running.
lwn │ >Demoting i686 Windows targets to std-only │ Demoting i686 Windows
> rust-blog │ Announcing Rust 1.99.0 │ targets to std-only
xkcd │ Announcing a Maintainer in Residence: │ Rust Blog · 3d ago
~ │ Scott Schafer for the Cargo team │ by Mateusz Mikuła, Ralf Jung
~ │ GitHub Actions leaking secrets when Miri │ --------------------------
~ │ output is cached │
~ │ Be alert: targeted attacks on prominent │ With Rust 1.100.0, the
~ │ Rustaceans │ following changes to
~ │ Rust debugging survey 2026 results │ 32-bit Windows targets
~ │ Announcing Rust 1.98.1 │ will happen:
~ │ Announcing rustup 1.29.1 │
~ │ Announcing our first Maintainers in │ - `i686-pc-windows-msvc`
~ │ Residence │ Tier 1 *with* host tools
~ │ Enabling the next-generation trait solver │ target will be demoted
~ │ on nightly │ to Tier 1 *without* host
~ │ ~ │ tools.
~ │ ~ │
~ │ ~ │ - `i686-pc-windows-gnu`
~ │ ~ │ Tier 2 *with* host tools
~ │ ~ │ target will be demoted
~ │ ~ │ to Tier 2 *without* host
~ │ ~ │ tools.
~ │ ~ │
~ │ ~ │ Builds of the standard
~ │ ~ │ library will continue to
-- NORMAL -- feed:rust-blog pane:reader 1/10 0%j/k move, h/l change pane, Enter reads, / searches, :links numbers every outbound URL. Full key list.
var/
Every action appends one JSON line. If you see entry.new, the file already exists and is complete.
$ tail -n 4 var/events.jsonl | cut -c1-150 {"v":1,"seq":43,"ts":"2026-10-05T02:41:34.203Z","event":"entry.new","feed":"lwn","data":{"id":"sha256:c6d5b2f4df92f72423830cf9cae43cf086a3da5b57428b2b {"v":1,"seq":44,"ts":"2026-10-05T02:41:34.203Z","event":"feed.health-changed","feed":"lwn","data":{"health":"ok"}} {"v":1,"seq":45,"ts":"2026-10-05T02:41:34.216Z","event":"feed.poll-succeeded","feed":"lwn","data":{"entries":15,"written":15,"next_poll_in":900}} {"v":1,"seq":46,"ts":"2026-10-05T02:41:34.217Z","event":"daemon.stopping","data":{}}
bin/
Python 3.12 or newer. Pick one:
$ uv tool install 'rssd-fs[tui]' $ brew install alliecatowo/tap/rssd $ rssd add https://blog.rust-lang.org/feed.xml --name rust-blog $ rssd once $ rss tui
Bring your subscriptions from any other reader with OPML, and take them back out the same way:
$ rssd import subscriptions.opml added hnrss.org https://hnrss.org/frontpage added blog.rust-lang.org https://blog.rust-lang.org/feed.xml 2 added, 0 skipped (already subscribed or invalid)
$ rssd export <?xml version='1.0' encoding='utf-8'?> <opml version="2.0"> <head> <title>rssd subscriptions</title> </head> <body> <outline type="rss" text="lwn" title="lwn" xmlUrl="https://lwn.net/headlines/rss"/> <outline type="rss" text="rust-blog" title="rust-blog" xmlUrl="https://blog.rust-lang.org/feed.xml"/> <outline type="rss" text="xkcd" title="xkcd" xmlUrl="https://xkcd.com/atom.xml"/> </body> </opml>