NewsAggregator

Global news feed with search —” RSS/Atom/JSON Feed aggregation, offline reading, cross-platform

Windows / Linux / macOS Python (PySide6/Qt) Information

NewsAggregator pulls news from anywhere —” RSS, Atom, JSON Feed, Reddit, Hacker News, Twitter/X —” into a unified, searchable reader.

Features

  • Multi-Source —” RSS/Atom/JSON Feed, Reddit (subreddits/multireddits), HN, Twitter/X lists, Mastodon
  • Unified Timeline —” Chronological or relevance-sorted with source badges
  • Full-Text Search —” SQLite FTS5 index across all articles; regex support
  • Offline Reading —” Articles cached locally; read anywhere without internet
  • Filters & Rules —” “Hide paywall”, “Only tech”, “Exclude politics” per feed
  • Read Later —” Pocket/Instapaper/Readwise sync; local bookmarks
  • Export —” EPUB, PDF, Markdown, JSON for offline archives
  • Themes —” Dark/light/sepia with custom fonts and line height

Installation

Windows

Download NewsAggregator-Setup.exe from Releases

Linux

# Flatpak
flatpak install flathub io.github.neohiro.NewsAggregator

# AppImage
wget https://github.com/neohiro/NewsAggregator/releases/latest/download/NewsAggregator.AppImage
chmod +x NewsAggregator.AppImage
./NewsAggregator.AppImage

macOS

brew install --cask newsaggregator

Quick Start

  1. Launch → “Add Source” → Paste RSS/Reddit/Twitter URL
  2. Name it, choose update interval (5m—“24h)
  3. Articles appear in unified feed
  4. Press / to search across all sources

Supported Sources

Type Examples
RSS/Atom Any blog, news site, podcast
JSON Feed Modern feeds (Micro.blog, etc.)
Reddit r/programming, r/rust+golang, user multireddits
Hacker News Front page, new, best, ask, show
Twitter/X Lists, users, searches (via Nitter)
Mastodon Hashtags, lists, local/federated timeline
YouTube Channel RSS (via invidious)

Privacy

  • Local-only —” No accounts, no cloud sync unless you configure it
  • No tracking —” Requests go directly to sources; no proxy
  • Tor support —” Route via Tor for anonymous fetching
  • Encrypted cache —” Optional AES-256 for article database

Keyboard Shortcuts

Key Action
j/k Next/prev article
o Open in browser
s Save for later
/ Focus search
f Toggle filter panel
t Toggle theme
r Refresh all sources

Configuration

~/.config/NewsAggregator/config.yaml:

update_interval_minutes: 30
max_articles_per_source: 100
cache_days: 90
theme: "auto"
font_family: "Inter"
font_size: 14
line_height: 1.6
search_engine: "sqlite_fts5"
offline_mode: false
tor_proxy: "socks5://127.0.0.1:9050"
  • opencode —” AI agent that can summarize feeds

This tool is free and open source. Support the developer: