feather/README.md

Feather: file-based RSS reader

Usage

Reading a feed

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

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.).

Theoretical use-cases

Processing with scripts

Syncthing

Installation

Docker

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

Raw

FAQ

Why

Name

What should I eat tonight

TODO

• Write documentation
• Perform mark-as-read operation more often than sync (inotify, daemon, etc.)
  • inotify might still be nice
• Make HTML filename configurable
• Make HTML template configurable
• Nested categories: ttrss-python?
• Share the fun somewhere
• Edge cases: mark as read during sync (if marked as read on server or not)
• Proper filename escaping
• Command to force regenerate all HTML files (incl. recompute datetimes & paths)
• Handle item updates
• Actually think about the issues created by the duplicate warning
• Set generated files creation/modification date instead of putting date in filename