A fast, keyboard-driven macOS reader for link-aggregator feeds (Lobsters, Hacker News) on Miniflux. Each item is its linked page plus its comments, in logged-in web views, so you can vote and reply without leaving the app. No animations, and the list never reorders under you: items you have read stay in place until you refresh.
- macOS 14 or later.
- Miniflux 2.0.49 or later (the first with the
changed_afterentries filter) and an API key: in Miniflux, Settings → API Keys → Create a new API key. linkboy asks for the server URL and key on first launch and keeps the key in the Keychain. The server must behttps://; plainhttp://is accepted only for a local server (localhost, a.localname or an IP address).
curl -fsSL https://raw.githubusercontent.com/lockyc/linkboy/main/install.sh | bashInstalls the notarized app to /Applications/linkboy.app. It updates itself afterwards
(linkboy → Check for Updates…).
| Key | Action |
|---|---|
j / k |
Next / previous item |
c |
Toggle page / comments |
s |
Star |
u |
Mark read / unread |
o |
Open in the default browser |
⌘[ / ⌘] |
Back / forward in the focused view (fixed) |
⌘R |
Sync now (fixed) |
j, k, c, s, u and o are rebindable in Settings and work while a web page has focus,
except when you are typing in one of its fields. Mouse side buttons go back and forward in the view
under the pointer, and ⌘-click opens a link in the default browser. Item → Mark All as Read… has
no key: it asks first, naming the count, and ⌘Z undoes it.
Pre-1.0 (0.x): reading, starring and marking read against a Miniflux server, with page and comment prefetch and in-app updates.
Needs Xcode's Swift 6 toolchain and just.
just test # unit tests
just gate # build + tests + shellcheck
just run # build and launch build/linkboy.app