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.tomlis 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.
No comments yet.
Sign in to be the first to comment.