goread
Terminal RSS/Atom feed reader with a Bubble Tea TUI, feed categories, offline mode, OPML support, and customizable colorschemes.
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


Alternatives & related tools
GORSS
Terminal RSS/Atom feed reader written in Go with SQLite storage, OPML import, configurable keybindings, custom commands and 8 built-in themes.
omm
Keyboard-driven task manager for the command line with priority reordering and context management
nom
Terminal RSS feed reader with a Bubbletea TUI, Glamour-rendered markdown articles, offline sqlite storage, Miniflux and FreshRSS backends, and Vim keybindings.
tz
Interactive TUI tool for displaying and comparing times across multiple time zones simultaneously
circumflex
Terminal-based Hacker News browser with vim-style navigation and built-in article reader
add a badge to your README
Maintain goread? Show that it's featured on trmn. The badge links back to this page.
[](https://www.trmn.sh/tools/goread?utm_source=badge)<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>