GORSS

Terminal RSS/Atom feed reader written in Go with SQLite storage, OPML import, configurable keybindings, custom commands and 8 built-in themes.

installยท Build from source

GORSS is a terminal RSS and Atom reader written in Go. It uses github.com/mmcdole/gofeed for parsing and stores articles and read state in a SQLite database, which is created automatically in the system's data home directory (override with -db). The interface has separate feed, article and preview panes. You switch between them with Tab or the number keys 1, 2 and 3.

Feeds are defined in a JSON configuration file, either as plain URL strings or as objects with url and name fields. They can also be loaded from an OPML file with opmlFile. Configuration and theme files are looked up under $XDG_CONFIG_HOME/gorss/ and are created from defaults if missing. You can also pass -config, -theme and -db explicitly. The config sets pane size ratios, update interval, the age at which old articles are skipped, and how long read or deleted articles stay in the database. It can also switch system notifications on or off.

Reading features include highlighting of configurable words, title search with /, sorting by date, unread state, title or feed, and marking articles read or unread (per article, per feed or globally). Undo of the last read mark is supported. You can open an article's link in the browser, or mark several articles and open them all at once. Every key binding is configurable. Custom commands can be bound to keys and run external programs, with ARTICLE.Content, ARTICLE.Link, ARTICLE.Feed and ARTICLE.Title substituted into the command. The README warns that no escaping is done.

There are 8 built-in themes embedded in the binary: default, irssi, night, dracula, nord, gruvbox, monokai and tokyo-night. Press T to cycle through them at runtime. Custom themes are JSON files with hex colors and configurable icons and markers. Prebuilt tarballs exist for Linux and macOS. The tool suits developers and terminal users who want a keyboard-driven, scriptable feed reader.

Installation

# via Build from source
make run

GORSS in action

GORSS default theme

GORSS irssi theme

Alternatives & related tools

add a badge to your README

Maintain GORSS? 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/gorss.svg)](https://www.trmn.sh/tools/gorss?utm_source=badge)
HTML
<a href="https://www.trmn.sh/tools/gorss?utm_source=badge"><img src="https://www.trmn.sh/badge/gorss.svg" alt="Featured on trmn" height="20"></a>