🍺 BREW Explorer

← all formulae

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

go

GitHub topics

atom bubbletea golang rss tui

Links

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
}