Skip to content
danielmerjaPublic
forked from ck-zhang/reddix

About

HN TUI – Hacker News, refined for the terminal.

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Latest commit

 

History

87 Commits

Folders and files

Repository files navigation

HN-TUI

Release License

HN-TUI - Browse Hacker News from the terminal.

Features

  • Browse Hacker News stories (Top, New, Best, Ask HN, Show HN, Jobs)
  • Read comments with threaded display
  • Keyboard-first navigation
  • No authentication required (HN API is public)
  • Terminal-native interface using Ratatui
  • Smart caching

Install

From Source

git clone https://github.com/danielmerja/hn-tui
cd hn-tui
cargo build --release
./target/release/hn-tui

Using Cargo

cargo install --git https://github.com/danielmerja/hn-tui

Usage

Simply run:

hn-tui

No configuration or authentication needed - the Hacker News API is completely public.

Keyboard Shortcuts

  • j/k - Navigate up/down in lists
  • h/l - Switch between panes (categories/stories/content)
  • Enter - View story or open comments
  • p - Refresh current view
  • q - Quit

Configuration

Configuration file is optional and located at ~/.config/hn-tui/config.yaml.

You can customize:

  • UI theme
  • Cache settings
  • Media preview settings

Environment Variables

  • HN_TUI_DISABLE_NERD_FONTS=1 - Use ASCII fallback icons instead of Nerd Font icons (helpful if icons appear as boxes or question marks)

About

HN-TUI is a fork of Reddix, refactored to work with Hacker News instead of Reddit.

Key changes:

  • Replaced Reddit OAuth with Hacker News Firebase API
  • Removed authentication (HN is public)
  • Adapted UI for HN story categories
  • Simplified configuration

License

MIT License - see LICENSE for details

Original Credits

This project is based on Reddix by ck-zhang. Original concept and UI design credit goes to the Reddix project.

About

HN TUI – Hacker News, refined for the terminal.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages