grokfeed is a terminal-based feed reader designed specifically for aggregating and displaying content from Hacker News, Reddit, and lobste.rs. It offers a streamlined way to consume updates and engage with popular online discussions through an intuitive text user interface (TUI).

Features

• Unified Feed: Experience a consolidated, scrollable feed that merges content from HN, Reddit subreddits, and lobste.rs, making it easy to keep up with the latest news and discussions.
• Color-Coded Accessibility: Content is color-coded by source—Hacker News in orange, lobste.rs in red, and Reddit subreddits in a cycling palette—facilitating quick content differentiation.
• Inline Reading: Read text posts and Ask HN responses directly in the terminal, eliminating the need for a web browser.
• Advanced Comment Viewing: View comments with nested replies (up to two levels) for deeper discussion insights.
• Customizable Filtering: Easily filter the feed by source and refresh content on demand to stay up to date.
• Automatic Configuration: The config file located at ~/.grokfeed/config.toml is auto-generated on the first run, simplifying setup.

Usage Example

To launch grokfeed, use the following command:

grokfeed

Key Bindings

Main Feed

Post Body Modal

Comments Modal

Configuration

Configuration can be managed through the default file located at ~/.grokfeed/config.toml, which is created upon the first launch:

subreddits = ["programming", "python", "machinelearning"]
hn_story_count = 30
reddit_post_count = 15
lobsters_post_count = 25

Edit this file to adjust the subreddits and other parameters; changes take effect upon the next launch or by refreshing with r.

Technology Stack

• Textual: TUI framework for the user interface.
• httpx: An asynchronous HTTP client supporting various web requests.
• Typer: For building the command-line interface.
• Rich: Used for advanced text rendering in the terminal.

With grokfeed, engage with the vibrant discussions from Hacker News, Reddit, and lobste.rs, all from the comfort of your terminal.