grokfeed — Read Hacker News, Reddit, and lobste.rs…

Pitch

Description

Comments

About this project

Grokfeed is a terminal feed reader that consolidates content from Hacker News, Reddit, and lobste.rs into one unified interface. With features like color-coded sources, inline reading, and a comments viewer, it offers an efficient way to stay updated without leaving the command line.

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

Key	Action
`j` / `↓`	Move down
`k` / `↑`	Move up
`Enter`	Open post body (text posts) or URL
`c`	Open comments
`f`	Cycle source filter
`r`	Refresh all sources
`q`	Quit

Post Body Modal

Key	Action
`j` / `↓`	Scroll down
`k` / `↑`	Scroll up
`c`	Open comments for this post
`o`	Open URL in browser
`q` / `Esc`	Close

Comments Modal

Key	Action
`j` / `↓`	Scroll down
`k` / `↑`	Scroll up
`q` / `Esc`	Close

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.