hckrnews 0.1.0

Command line tool to display HN top stories

hckrnews - Hacker News CLI Viewer

A command line tool to display the top stories from Hacker News using the API provided by hckrnews.com.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Features

• View top stories from Hacker News in your terminal
• Color-coded titles based on story score:
  • Green: Top 10 stories
  • Yellow: Stories ranked 11-20
  • Purple: Stories in the top 50% (excluding top 20)
  • Grey: Other stories
• 2-column layout showing titles and points/comments
• Various filtering options:
  • Top 10 stories
  • Top 20 stories
  • Top 50% of stories
  • All stories
• Navigation between different days
• Multiple sorting options:
  • By points
  • By comments
  • By submission date
• Keyboard shortcuts for all actions

Installation

From PyPI (Recommended)

Install directly from PyPI:

pip install hckrnews

Or if you're using uv:

uv pip install hckrnews

Development Installation

Clone this repository and install in development mode:

cd hckrnews
pip install -e .

Or if you're using uv:

cd hckrnews
uv pip install -e .

Usage

Simply run the hckrnews command to start the application:

hckrnews

Keyboard Shortcuts

• j - Previous day (earlier)
• k - Next day (later)
• l - Open comments page in browser
• space - Open story URL in browser
• 1 - Show top 10 stories
• 2 - Show top 20 stories
• 3 - Show top 50% stories
• 4 - Show all stories
• p - Sort by points
• c - Sort by comments
• d - Sort by date
• r - Refresh current view
• q - Quit the application
• Arrow keys - Navigate between stories

Data Source

Data is fetched from the hckrnews.com API: https://hckrnews.com/data/YYYYMMDD.js