goread
brew install goread
v1.7.3
GPL-3.0-or-later
RSS/Atom feeds in the terminal
10
30-day installs · #8661
16
90-day · #10330
131
365-day · #8468
488
★ GitHub stars · updated 10mo ago
Build dependencies
GitHub topics
atom
bubbletea
golang
rss
tui
Links
- https://github.com/TypicalAM/goread
- GitHub: TypicalAM/goread
- Brew formula source: Formula/g/goread.rb
Raw metadata
{
"aliases": [],
"alternatives": [],
"build_dependencies": [
"go"
],
"categories": [],
"caveats": null,
"conflicts_with": [],
"dependencies": [],
"deprecated": 0,
"deprecation_reason": null,
"desc": "RSS/Atom feeds in the terminal",
"disable_reason": null,
"disabled": 0,
"enrichment_fetched_at": "2026-06-20T23:38:19+00:00",
"first_seen": "2026-06-20T23:34:18+00:00",
"full_name": "goread",
"github_default_branch": "main",
"github_last_commit_at": "2025-10-03T20:34:36Z",
"github_readme_excerpt": "\u003cp align=\"center\"\u003e\n \u003cimg width=\"500\" src=\"assets/cover.png\" /\u003e\n\u003c/p\u003e\n\n\ud83d\udc4b Hello! goread is an RSS/Atom feed reader for the terminal. It allows you to categorize and follow feeds and read articles right in the commandline! It\u0027s accompanied by a beautiful TUI made with [bubble tea](https://github.com/charmbracelet/bubbletea). Features include:\n\n- Categorizing feeds\n- Downloading articles for later use\n- Offline mode\n- Customizable colorschemes\n- OPML file support\n- A nice and simple TUI\n\n## \u2764\ufe0f Getting started\n\n### Installing with `go install`\n\nYou can install goread using the `go` internal package manager\n\n```\n$ go install github.com/TypicalAM/goread@latest\n```\n\n### Installing with `homebrew`\n\nIf you use [Homebrew](https://brew.sh/), you can install [goread](https://formulae.brew.sh/formula/goread) via:\n\n```\n$ brew install goread\n```\n\n### Installing from AUR\n\nIf you use the [AUR](https://aur.archlinux.org/), you can install [goread](https://aur.archlinux.org/packages/goread) via:\n\n```\n$ yay -S goread\n```\n\n```\n$ yay -S goread-bin # Release binary\n```\n\n## \ud83d\udcf8 What does it look like?\n\nHere is a gif of some basic usage:\n\n\u003cp align=\"center\"\u003e\n \u003cimg width=\"700\" src=\"assets/example1.gif\" /\u003e\n\u003c/p\u003e\n\nYou can use a colorscheme from `pywal` to create a goread colorscheme!\n\n\u003cp align=\"center\"\u003e\n \u003cimg width=\"700\" src=\"assets/example2.gif\" /\u003e\n\u003c/p\u003e\n\n## \u2699\ufe0f Configuration\n\n### \ud83d\udcdd The urls file\n\nThe urls file contains the categories and feeds that you are subscribed to! This file is generated by the program in the config directory (usually `~/.config/goread/urls.yml`) and looks similar to this:\n\n```yaml\ncategories:\n - name: News\n desc: News from around the world\n subscriptions:\n - name: BBC\n desc: News from the BBC\n url: http://feeds.bbci.co.uk/news/rss.xml\n blacklist_words:\n - example\n - name: Tech\n desc: Tech news\n subscriptions:\n - name: Wired\n desc: News from the wired team\n url: https://www.wired.com/feed/rss\n - ",
"github_repo": "TypicalAM/goread",
"github_stars": 488,
"github_topics": [
"atom",
"bubbletea",
"golang",
"rss",
"tui"
],
"homepage": "https://github.com/TypicalAM/goread",
"homepage_og_description": null,
"homepage_og_image": null,
"homepage_title": null,
"installs_30d": 10,
"installs_365d": 131,
"installs_90d": 16,
"keg_only": 0,
"keg_only_reason": null,
"last_seen": "2026-06-20T23:34:18+00:00",
"license": "GPL-3.0-or-later",
"llm_generated_at": null,
"llm_model": null,
"name": "goread",
"oldnames": [],
"one_liner": null,
"optional_dependencies": [],
"rank_30d": 8661,
"rank_365d": 8468,
"rank_90d": 10330,
"raw_hash": "858d8a31779ee8b6",
"recommended_dependencies": [],
"revision": 0,
"ruby_source_path": "Formula/g/goread.rb",
"tap": "homebrew/core",
"test_dependencies": [],
"uses_from_macos": [],
"version_head": "HEAD",
"version_stable": "1.7.3",
"versioned_formulae": [],
"why_use_this": null
}