# Install goread with Homebrew, Nix RSS/Atom feeds in the terminal. Version 1.7.3 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:goread ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install goread ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#goread ``` Evidence: nixpkgs package indexes: pkgs/by-name/go/goread/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:goread - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.7.3 - **Source summary:** RSS/Atom feeds in the terminal - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later - **Source archive:** - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - goread (cli) - goread (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.7.3 - Local data: ok - Upstream repository: https://github.com/TypicalAM/goread - Upstream latest detected: v1.7.3 (current) - info: No package-manager update timestamp was available. ## Project history and usage goread is a terminal RSS/Atom reader written in Go. Its package history is small but clear: a Bubble Tea TUI feed reader distributed through Go install, Homebrew, AUR, and Nix. ### Project history The TypicalAM/goread repository was created in 2022. The README describes it as an RSS/Atom feed reader for the terminal that categorizes feeds, downloads articles for later use, supports offline mode, imports OPML, and uses a Bubble Tea TUI. The project follows the modern Go CLI/TUI pattern: Cobra for command flags, Bubble Tea and Lip Gloss for terminal UI, and gofeed for RSS/Atom parsing. ### Adoption history Adoption appears modest and package-oriented. The README documents installation through `go install`, Homebrew, and the Arch User Repository, while the input facts also list Nix packaging. The README's install instructions and dependency credits place goread in the terminal-reader and Go TUI audience rather than in a broad desktop RSS-reader market. ### How it is used Users run goread to manage feed categories and read RSS/Atom articles in a terminal UI. The README documents generated configuration under `~/.config/goread`, including `urls.yml`, `colorscheme.json`, and `goread.yml`. The tool supports editing feeds through `goread edit urls`, custom keybindings through `goread edit config`, pywal-derived colors, OPML support, article downloads, and offline reading. ### Why package nerds care goread is a compact example of the Charmbracelet-era Go TUI package ecosystem: a small single-user terminal app assembled from Bubble Tea, Lip Gloss, Cobra, and a domain library. Its documented config files are also package-manager useful because maintainers and users can smoke-test the binary without external services beyond feed URLs. ### Timeline - 2022: TypicalAM/goread repository created. - 2024: README license text identifies Adam Piaseczny and GPL terms. - 2020s: README documents Homebrew, AUR, Go install, and generated config-file paths. ### Related projects - Bubble Tea provides the TUI runtime. - Lip Gloss provides terminal styling. - Cobra provides command-line flag handling. - gofeed parses RSS and Atom feeds. ### Sources - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: ~/.config/goread/urls.yml, ~/.config/goread/colorscheme.json, ~/.config/goread/goread.yml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** goread - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - goread: normalized package name match | nixpkgs package indexes: pkgs/by-name/go/goread/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [bulletty](https://www.automicvault.com/pkg/brew/bulletty/) - Shares av.db curated category or tags: atom, cli, feed-reader, productivity, rss. - [miniflux](https://www.automicvault.com/pkg/brew/miniflux/) - Shares av.db curated category or tags: atom, cli, feed-reader, productivity, rss. - [snownews](https://www.automicvault.com/pkg/brew/snownews/) - Shares av.db curated category or tags: atom, cli, feed-reader, productivity, rss. - [newsboat](https://www.automicvault.com/pkg/brew/newsboat/) - Shares av.db curated category or tags: atom, cli, feed-reader, productivity, rss. - [newsraft](https://www.automicvault.com/pkg/brew/newsraft/) - Shares av.db curated category or tags: atom, cli, feed-reader, productivity, rss. - [nom](https://www.automicvault.com/pkg/brew/nom/) - Shares av.db curated category or tags: cli, feed-reader, productivity, rss, terminal. - [matcha](https://www.automicvault.com/pkg/brew/matcha/) - Shares av.db curated category or tags: cli, feed-reader, productivity, rss. - [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, productivity, terminal. ## Combined YAML source View the package source record on GitHub. [combined/goread.yml](https://github.com/automic-vault/db/blob/main/combined/goread.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph