russ

TUI RSS/Atom feed reader with vim-style modal controls, a SQLite database for storage, and OPML import. Works fully offline.

install

russ is a terminal RSS/Atom reader written in Rust. It uses a modal interface like vim, with a normal mode for reading and navigation and an insert mode for subscribing to feeds. In normal mode, hjkl or the arrow keys move between feeds and entries and scroll entry text. Other keys refresh the selected feed (r) or all feeds (x), toggle between read and unread entries (a), copy a link to the clipboard (c), and open a link in the browser (o). In insert mode, you type a feed URL and press Enter to subscribe, or press Del to delete the selected feed.

All data is kept in a SQLite database, feeds.db. Its default location depends on the platform, and -d overrides it. russ does not refresh feeds on a timer and does not mark entries as read automatically. It only does these things when you ask, so you can read already-downloaded entries without a network connection. The bundled SQLite is version 3.45.1, and you can also query the database directly with SQL for tasks such as analysis or removing duplicates.

The CLI has two subcommands: russ read starts the TUI, and russ import --opml-path <file> imports feeds from an OPML document. Options include --tick-rate, --flash-display-duration-seconds, and --network-timeout (default 5 seconds). Feeds are refreshed in parallel using a database connection pool. The author develops it mainly on macOS and has run it on Linux and WSL. Windows is untested. It suits people who want a keyboard-driven, local feed reader in the terminal.

Installation

# via Cargo
cargo install russ --git https://github.com/ckampfe/russ
# via apt (Linux system dependencies)
sudo apt update && sudo apt install libxcb-shape0-dev libxcb-xfixes0-dev

russ feed and entry list view

russ reading an entry

Alternatives & related tools

add a badge to your README

Maintain russ? Show that it's featured on trmn. The badge links back to this page.

Featured on trmn
Markdown
[![Featured on trmn](https://www.trmn.sh/badge/russ.svg)](https://www.trmn.sh/tools/russ?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/russ?utm_source=badge"><img src="https://www.trmn.sh/badge/russ.svg" alt="Featured on trmn" height="20"></a>