russ
TUI RSS/Atom feed reader with vim-style modal controls, a SQLite database for storage, and OPML import. Works fully offline.
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


Alternatives & related tools
outside
Terminal weather client with multiple output formats including TUI, JSON, and Waybar integration
bulletty
Terminal RSS/Atom feed reader that downloads entries for offline reading and stores feeds and articles as local Markdown files.
eilmeldung
Terminal RSS/news reader in Rust built on the news-flash library, with vim-style keybindings, mouse support, an article query language and many RSS providers.
basalt
Terminal user interface (TUI) for managing Obsidian vaults and notes from the command line
kalker
Scientific calculator CLI with support for calculus, variables, functions, matrices, and multiple number bases
add a badge to your README
Maintain russ? Show that it's featured on trmn. The badge links back to this page.
[](https://www.trmn.sh/tools/russ?utm_source=badge)<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>