# russ

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

Stars: 267 · Language: Rust · License: AGPL-3.0 · Categories: Productivity

- Repository: https://github.com/ckampfe/russ
- Page: https://www.trmn.sh/tools/russ

## Install

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

## Overview

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

```bash
# via Cargo
cargo install russ --git https://github.com/ckampfe/russ
```

```bash
# via apt (Linux system dependencies)
sudo apt update && sudo apt install libxcb-shape0-dev libxcb-xfixes0-dev
```

![russ feed and entry list view](https://media.trmn.sh/cached/40905b96034137e180e4bd31a62090ddb2f9ea71d6a5679bf95e3737bce29c8e.png)

![russ reading an entry](https://media.trmn.sh/cached/c8dce1b0c4acc34527458dae206072ba5fe99cea9e93b651cde9e70e8d3e2ce8.png)

## Alternatives

- [outside](https://www.trmn.sh/tools/outside.md): Terminal weather client with multiple output formats including TUI, JSON, and Waybar integration (Rust, 103 stars)
- [bulletty](https://www.trmn.sh/tools/bulletty.md): Terminal RSS/Atom feed reader that downloads entries for offline reading and stores feeds and articles as local Markdown files. (Rust, 453 stars)
- [eilmeldung](https://www.trmn.sh/tools/eilmeldung.md): 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. (Rust, 1.1k stars)
- [basalt](https://www.trmn.sh/tools/basalt.md): Terminal user interface (TUI) for managing Obsidian vaults and notes from the command line (Rust, 1.4k stars)
- [kalker](https://www.trmn.sh/tools/kalker.md): Scientific calculator CLI with support for calculus, variables, functions, matrices, and multiple number bases (Rust, 1.9k stars)

## Guides

- [Best terminal RSS readers](https://www.trmn.sh/best/terminal-rss-readers): Compare newsboat, eilmeldung and nom, plus goread, GORSS, bulletty and russ, for reading RSS and Atom feeds in the terminal.

---

Canonical: https://www.trmn.sh/tools/russ
