Documentation

Everything you need to know about using Feedo to read your RSS feeds.

Installation

Choose your preferred installation method:

Homebrew (Recommended)

brew install ricardodantas/tap/feedo

Cargo

cargo install feedo

Pre-built Binaries

Download pre-built binaries from the GitHub Releases page. Available for:

Linux (x86_64, aarch64)
macOS (Intel, Apple Silicon)
Windows (x86_64)

Quick Start

Launch Feedo
```
feedo
```
Add your first feed
Press n to open the add feed dialog, then paste a URL. Feedo will auto-detect the RSS/Atom feed.
Navigate and read
Use j/k to move, Enter to select, and o to open in browser.

Adding Feeds

Press n to add a new feed. You can enter:

Direct feed URL - RSS/Atom feed URL
Website URL - Feedo will auto-discover the feed

Feedo automatically detects feeds from websites using standard meta tags and common feed paths.

Keybindings

Navigation

Key	Action
`j` / `↓`	Move down
`k` / `↑`	Move up
`l` / `→` / `Enter`	Select / Enter
`h` / `←`	Go back
`g`	Jump to top
`G`	Jump to bottom
`Tab`	Switch panels

Actions

Key	Action
`n`	Add new feed
`d` / `Del`	Delete feed
`r`	Refresh all feeds
`o`	Open in browser
`Space`	Toggle read/unread
`a`	Mark all as read
`/`	Search
`t`	Theme picker
`?`	Help
`A`	About
`q` / `Esc`	Quit

Searching

Press / to open the search dialog. Search works across:

Article titles
Article content
Feed names

Results update in real-time as you type. Press Esc to close search.

Folders

Organize your feeds into folders for easier navigation:

Folders can be collapsed/expanded with Enter
Add custom emoji icons to folders
Drag and drop feeds between folders (coming soon)

Config File

Feedo stores its configuration at ~/.config/feedo/config.toml:

# Theme (see Themes page for all options)
theme = "dracula"

# Refresh interval in minutes
refresh_interval = 30

# Maximum articles to keep per feed
max_articles = 100

# Open links in browser
browser = "default"

Themes

Feedo comes with 15 beautiful themes. Change themes by:

Pressing t in the TUI for live preview
Setting theme = "theme-name" in config

See the Themes page for all available options.

OPML Import/Export

Migrate your feeds from other RSS readers:

Import

feedo import feeds.opml

Export

feedo export > feeds.opml