goread

Terminal RSS/Atom feed reader with a Bubble Tea TUI, feed categories, offline mode, OPML support, and customizable colorschemes.

install

goread is an RSS/Atom feed reader that runs in the terminal. You organize feeds into categories, follow them, and read articles directly in the command line. The interface is a TUI built on bubble tea, with lipgloss for styling, cobra for flags, and gofeed for parsing feeds.

Beyond reading, goread can download articles for later use and has an offline mode. It supports OPML files. Subscriptions are stored in a YAML urls file (usually ~/.config/goread/urls.yml) that holds categories, feed names, descriptions, and URLs. Feeds can have blacklist_words and whitelist_words to filter entries. You can edit this file with goread edit urls or from inside the TUI.

Appearance and input are configurable. The colorscheme lives in ~/.config/goread/colorscheme.json and can be written by hand or generated with the --dump_colors flag. The --get_colors flag builds a colorscheme from a pywal colors.json file. Custom keybindings go in goread.yml, which goread edit config opens in your $EDITOR. It suits terminal users who want to manage feeds without a browser or GUI reader.

Installation

# via Homebrew
brew install goread
# via Go
go install github.com/TypicalAM/goread@latest
# via AUR
yay -S goread

goread basic usage

goread with a pywal colorscheme

Alternatives & related tools

add a badge to your README

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