Feather: file-based RSS reader client

Usage

start with pictures/gif each time

Navigating feeds

Directories, sorting/searching by date/title (a.k.a. using a file manager)

Reading an item

opening an item

Marking items as read

Delete

See read items in the trash can

Updating with the server

Call feather sync to synchronize all local data with the server (read items, new items from the server, etc.).

feather daemon

Configuration

After changing the configuration, you can call feather regenerate to regenerate all local files with the new configuration (to reflect the changes in the HTML template, filenames, etc.).

feather clear-data

Theoretical use-cases

Processing with scripts

Syncthing

Installation

Docker

docker run -d -v ./config.toml:/feather/config.toml -v feather-data:/feather/data -v ./reader:/feather/reader --name feather feather daemon

Raw

You need Python 3.12 or newer. Then pip it up, as the kids say.

uv run feather

FAQ

Why

Name

What should I eat tonight

TODO

Write documentation
Use inotify for real-time article mark-as-read action
Share the fun somewhere
Actually think about the issues created by the duplicate warning
Get article attachments
Test with FreshRSS

1.3 KiB Raw Blame History