feed

A simple RSS/Atom feed reader for the terminal.

Install

cargo install feed-reader

How to use

Read articles (default: TUI mode)

Run feed without any subcommand. It shows articles from all your feeds.

Manage feeds

feed add <url>                         # Add a feed (title is fetched automatically)
feed add <url> --name "My Feed"        # Add a feed with a custom name
feed add <url> --tag tech --tag rust   # Add a feed with tags
feed remove <name or url>              # Remove a feed
feed list                              # List all feeds
feed tags                              # List all tags

Fetch once

feed fetch-feed <url>                  # Show entries from a feed URL
feed fetch-article <url>               # Extract and show article content

TUI key bindings

Article list

Article view

Config file

The program looks for a config file in this order:

1. The path you give with --config <path>
2. $XDG_CONFIG_HOME/feed/config.yaml (default: ~/.config/feed/config.yaml)

feeds:
  - name: "Rust Blog"
    url: "https://blog.rust-lang.org/feed.xml"
    tags: ["tech", "rust"]
    # extractor: rss_content  # You can set this per feed

cache:
  retention_days: 90   # 0: keep forever, -1: no cache
  # path: /path/to/cache
  # Default cache location: $XDG_DATA_HOME/feed/ (default: ~/.local/share/feed/)

content:
  extractor: readability  # "readability" (default) or "rss_content"
  auto_mark_read: true    # Mark articles as read when you open them (default: true)
  # If readability fails, it falls back to RSS content automatically

tui:
  auto_refresh_interval: 300  # Auto-refresh interval in seconds. 0: off (default)