Skip to content

Repository files navigation

CyberFeeds Logo

CyberFeeds β€” RSS Reader

Download Latest ReleaseWindows 64-bit Β All Releases

LicenseΒ  PlatformΒ  ElectronΒ  Wiki

A performance-first, full-featured RSS/Atom feed reader built with Electron + React + TypeScript. Subscribe to feeds, read articles with full-content extraction, manage your reading flow with star/read/unread/trash, and receive smart notifications when new articles are published.

Free and open source (GPLv3) β€” no ads, no tracking, and no data collection. Just enjoy it.


πŸ“‘ Why CyberFeeds?

Most RSS readers are either slow web wrappers or abandoned projects. CyberFeeds is built from the ground up for performance and usability β€” worker threads keep fetching responsive, SQLite WAL mode handles thousands of articles smoothly, and a custom notification system ensures you never miss important updates.

Need Solution
Follow RSS, Atom, and Reddit Native support for all formats + Reddit subreddits and user feeds
Read full articles Content extraction via worker threads β€” no truncated summaries
Stay updated Smart notifications with keyword filtering, snooze, and multi-monitor support
Manage large libraries Virtualized lists, search, star/read/unread, auto-cleanup
Migrate from another reader OPML import/export with folder structure preserved
Keep your data Local SQLite database β€” no cloud, no accounts, no tracking

✨ Key Features

πŸ“° Feed Management

  • Universal Feed Support β€” RSS, Atom, and XML with automatic discovery
  • Reddit Integration β€” Native subreddit and user feed support with fallback chain (RSS β†’ JSON API)
  • OPML Import/Export β€” Migrate your feeds with folder structure preserved
  • Feed Preview β€” Preview feed content before subscribing
  • Feed Doctor β€” Diagnostic scanner for connectivity and parsing issues
  • Background Polling β€” Configurable refresh intervals with per-feed and per-folder pause/resume

πŸ“– Article Management

  • Full-Content Extraction β€” Fetch complete article content via worker threads
  • Star/Unstar β€” Mark articles as favorites
  • Read/Unread Tracking β€” Know what you've read at a glance
  • Soft Delete β€” Move articles to trash with 30-day auto-purge
  • Instant Search β€” Search articles with instant or Enter-to-search modes
  • Virtualized Lists β€” Smooth scrolling for large article libraries
  • Multiple Layouts β€” Three-panel, two-panel, one-panel, and horizontal-split views

πŸ”” Smart Notifications

  • Custom Notification Window β€” Built-in notifier with batching and action buttons
  • Keyword Filtering β€” Only get notified about topics that matter
  • Snooze β€” Pause notifications for a configurable duration
  • Multi-Monitor Support β€” Choose which display shows notifications
  • Sound Alerts β€” Custom notification sounds
  • Fullscreen Detection β€” Suppress notifications during games or videos

πŸ–₯️ Desktop Integration

  • System Tray β€” Minimize to tray, quick actions menu, activity indicator
  • Global Hotkeys β€” Configurable shortcuts (default show/hide: Alt+Shift+S)
  • Auto-Start β€” Start with Windows option
  • Auto-Updates β€” Built-in update checker with manual download control
  • Custom Browser β€” Open links in a user-selected browser

🎨 Customization

  • 7 Themes β€” Dark, Light, Dracula, Nord, Hacker, Monokai, and Default
  • Reading Preferences β€” Font size, line height, max width, reading theme (Default, Sepia, Dark)
  • Bilingual UI β€” Full English and Spanish interface

πŸ’Ύ Data Management

  • Backup & Restore β€” JSON-based backup of feeds, folders, and settings
  • Auto-Cleanup β€” Automatically delete old read articles
  • SQLite Database β€” High-performance local storage with WAL mode

πŸ› οΈ Tech Stack & Architecture

  • Platform: Windows (primary target), macOS, Linux
  • Framework: Electron 34 + React 19 + TypeScript
  • Build: electron-vite 5 (Vite 6)
  • State: Zustand 5
  • Database: better-sqlite3 (WAL mode)
  • Virtualization: TanStack Virtual
  • Packaging: electron-builder (NSIS)
src/
β”œβ”€β”€ main/                  Electron main process
β”‚   β”œβ”€β”€ index.ts           App initialization, window creation
β”‚   β”œβ”€β”€ ipc.ts             IPC channel handlers
β”‚   β”œβ”€β”€ db.ts              SQLite database layer
β”‚   β”œβ”€β”€ feed-parse.ts      Feed parsing with fallbacks
β”‚   β”œβ”€β”€ polling.ts         Background polling orchestration
β”‚   β”œβ”€β”€ tray.ts            System tray, shortcuts, context menu
β”‚   β”œβ”€β”€ notifications.ts   Custom notifier window
β”‚   β”œβ”€β”€ updater.ts         Auto-update lifecycle
β”‚   β”œβ”€β”€ opml.ts            OPML import/export
β”‚   └── workers/
β”‚       β”œβ”€β”€ feed-fetcher.worker.ts      Parallel feed fetching
β”‚       └── content-extractor.worker.ts Article content extraction
β”œβ”€β”€ preload/               Context bridge API
β”‚   └── index.ts           window.api exposure
β”œβ”€β”€ renderer/              React application
β”‚   β”œβ”€β”€ notifier/          Notification window React app
β”‚   └── src/
β”‚       β”œβ”€β”€ components/    UI components
β”‚       β”œβ”€β”€ hooks/         Custom React hooks
β”‚       β”œβ”€β”€ store/         Zustand stores
β”‚       └── styles/        Global CSS and themes
└── shared/                Isolated shared code
    β”œβ”€β”€ types.ts           Shared TypeScript interfaces
    β”œβ”€β”€ translations.ts    EN/ES UI strings
    └── reddit.ts          Reddit URL handling

Architecture Highlights

  • Worker Threads β€” Feed fetching and content extraction run in dedicated workers to keep the main process responsive
  • Optimistic UI β€” Article state updates immediately in the renderer, then syncs with the main process
  • CSS Variable Resizing β€” Column/row resizing updates DOM directly during drag (zero React re-renders)
  • Context Bridge β€” Strict preload API surface with no Node integration in renderer
  • WAL Mode SQLite β€” High-performance concurrent reads with write-ahead logging

πŸš€ Getting Started

Prerequisites

Development

npm install
npm run dev

Note: The postinstall script automatically rebuilds better-sqlite3 for the current Electron version.

Build

npm run build          # Production build
npm run build:win      # Windows installer
npm run build:unpack   # Directory output (no installer)

Code Quality

npm run typecheck      # Type checking
npm run lint           # Linting
npm run format         # Formatting

πŸ›‘οΈ Windows SmartScreen

Windows may show a SmartScreen warning the first time you run the CyberFeeds installer β€” this is an unsigned hobby app, so Windows hasn't built reputation for the file yet. This is expected; the source is public so you can inspect exactly what it does.

To continue:

  1. Click More info.
  2. Click Run anyway.

⌨️ Keyboard Shortcuts

Key Action Scope
Alt+Shift+S Show/hide CyberFeeds Global
Escape Close panel Application

Additional shortcuts (Notifications, Settings, Fetch Now) are configurable in Settings β†’ Keyboard.


❓ Frequently Asked Questions

What feed formats does CyberFeeds support?

RSS, Atom, and XML feeds. It also supports Reddit subreddits and user feeds natively, with a fallback chain from RSS to the Reddit JSON API.

Can I import my feeds from another reader?

Yes. CyberFeeds supports OPML import and export, preserving your folder structure. Go to the sidebar menu and select Import OPML.

How do notifications work?

CyberFeeds has a custom notification system that shows a native-looking popup when new articles are published. You can filter notifications by keywords, snooze them, choose position and monitor, and suppress them during fullscreen applications.

Where is my data stored?

All data is stored locally in a SQLite database. No cloud sync, no accounts, no tracking. You can export a JSON backup at any time from Settings β†’ Maintenance.

Does CyberFeeds support macOS and Linux?

Windows is the primary target, but Electron builds for macOS and Linux are supported. Check the releases page for available platforms.


❀️ Donate

CyberFeeds is one of the gems in CyberGems, a personal suite I've spent thousands of hours building and refining for my own use. I've decided to share the whole suite with the world β€” completely free and open-source.

If you'd like to support this work, a donation would mean a lot. Thank you! πŸ™

Donate via PayPal

Support me on Ko-fi

Buy Me a Coffee

Crypto donations (BTC, ETH, USDT, LTC) β€” click to view addresses
Asset Address QR
BTC
bc1q5mxzz05nmvsheqzx7970euswta3fksxzcfzag4
BTC QR
ETH
0x79b703Ec0f77493679Fcd280aF3b983E20c580B8
ETH QR
USDT (ERC20 / BEP20)
0x79b703Ec0f77493679Fcd280aF3b983E20c580B8
USDT QR
USDT (TRC20)
TSVbSk1HSyZ1NprCnAYiw56ECwXgH887mD
USDT TRC20 QR
LTC
LWGnEHgcFCE2BRkzLnsdPDD8Y8ZeDK577X
LTC QR

⚠️ Send only the selected asset on the indicated network. Using the wrong network will result in permanent loss of funds.


πŸ“„ License

CyberFeeds is distributed under the terms of the GNU General Public License v3.0. See LICENSE for the full license text.


Thanks for using CyberFeeds! πŸŽ‰

Made by CyberGems

About

πŸ“’ CyberFeeds is a high-performance, local-first RSS and Atom reader built for speed, privacy and clean reading with smart sync β€” free, open-source and private.

Topics

Resources

Stars

4 stars

Watchers

2 watching

Forks

Releases

Contributors

Languages