Readn

README

Readn

Readn is a web-based feed aggregator which can be used both as a desktop application and a personal self-hosted server.

This is a fork of the original yarr project by nkanaev, enhanced with additional features:

Enhanced Features

• AI Features: Article summarization, interactive chat, and text selection actions (explain/summarize). All AI features can be individually disabled.
• Discussion integration: Allow fetching and displaying comment threads from Hacker News and Lobste.rs when available for articles.

The app remains a single binary with an embedded database (SQLite) for easy deployment.

usage

The latest prebuilt binaries for Linux/MacOS/Windows are available here. The archives follow the naming convention readn_{OS}_{ARCH}[_gui].zip, where:

• OS is the target operating system
• ARCH is the CPU architecture (arm64 for AArch64, amd64 for X86-64)
• -gui indicates that the binary ships with the GUI (tray icon), and is a command line application if omitted

Usage instructions:

• MacOS: place readn.app in /Applications folder, open the app, click the anchor menu bar icon, select "Open".

• Windows: open readn.exe, click the anchor system tray icon, select "Open".

• Linux: place readn in $HOME/.local/bin and run the script.

For self-hosting, see readn -h for auth, tls & server configuration flags.

See more:

• Building from source code
• Fever API support

credits

Special thanks to nkanaev for creating the original yarr project.

Phosphor Icons for the app logo (newspaper). Feather for icons.