Skip to content

darrell-roberts/hacker-news

Repository files navigation

My Hacker News Reader

  • View top/best/new/ask/show/job stories.
  • Each category is indexed locally.
  • Read comments and nested comments.
  • Search stories.
  • Search comments.
  • Watch stories via server side events.

Install Options

MacOS (ARM)

Download prebuilt dmg from releases.

Will require allowing non app store & known developers when launching. Open System Settings -> Privacy & Security and under Security allow running app.

Linux (X86_64)

Download Linux app image, flatpak or debian package from releases.

App image

Unzip and grant execute permission to the app image and run it.

Flatpak

Download the hacker-news.flatpak file and run flatpak install hacker-news.flatpak.

Build from source.

Build prerequisites

Each install method will build and package from source. You'll first need to clone this repo.

git clone https://github.com/darrell-roberts/hacker-news.git
cd hacker-news

You'll need the Rust compiler toolchain.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Build & Install as binary

cargo install --path hacker-news-iced --bin hacker-news-iced

Build & Install as Mac app

Run the provided Makefile target

make install

This will create a dist/Hacker News.dmg file and open/mount it. Simply copy the contents into your Application folder.

Build & Install as Linux Desktop App.

Run the provided Makefile target

make install

This copies the binary and other assets into your ~/.local.

Screenshots

MacOS Dark mode theme

Screenshot 2024-12-29 at 12 17 58 PM

Linux Dark mode theme

Screenshot from 2024-12-29 11-45-07