Self-host rss-reader
v2.1Minimalist self-hosted RSS feed reader with dark mode
- Stars
- 438
- Port
- 8080 (HTTP and WebSocket server)
srcrs/rss-reader
What is rss-reader?
rss-reader is a minimalist RSS feed aggregator designed for self-hosting via Docker. It fetches multiple RSS/Atom feeds on a configurable interval and serves a clean web UI that updates in real time over WebSocket. The interface supports dark mode with configurable day/night switching times, hot-reloads its config.json without restart, and uses a responsive layout that works on desktop and mobile. The Docker image is about 20 MB, built on Alpine, and exposes port 8080. No database or external services are required — feed data is fetched and cached in memory. The project is open source under MIT and has stable releases up to v2.1.
Should you self-host rss-reader?
rss-reader scores 47/100 on selfhost.directory (how scoring works) and ranks #41 of 85 in Feed Reader. It has 438 GitHub stars.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in Go.
Its closest alternative on selfhost.directory is RSSHub (85/100, 46 704 stars). It scores higher overall, so compare the two before you pick. See rss-reader vs RSSHub side by side.
Features
- Auto-refresh frontend
- Configurable feed refresh interval
- Dark mode with scheduled switching
- Hot configuration reload
- Multiple RSS/Atom feed aggregation
- Real-time WebSocket updates
- Responsive Design
- SEO-friendly server-side rendering
- Shows feed last-updated timestamps
rss-reader README
More in Feed Reader
rss-to-activitypubSelf-hosted Node.js server that converts any RSS feed into an ActivityPub actor followable from Mastodon and other federated platforms, with OAuth-gated feed creation.
rsstodolistSelf-hosted, open-source URL-to-RSS bridge converting bookmarks into private or shareable RSS feeds with auto metadata scraping and PostgreSQL/MariaDB backend.
RSS-to-Telegram-BotSelf-hosted, open-source Telegram bot that pushes RSS and Atom feeds to chats and channels with rich formatting, media, OPML import/export, and multi-user support.
seblucas-copsA self-hosted PHP application that serves Calibre ebook libraries through OPDS feeds and a responsive web catalog, offering a lighter alternative to Calibre's own server.
selfossOpen-source, self-hosted PHP web app that pulls feeds, tweets and posts into one stream, with OPML import, regex filters, a spout plugin system and a REST JSON API.
Sismics ReaderSismics Reader is a self-hosted, open-source RSS/Atom feed aggregator with responsive web UI, full-text search, OPML import/export, REST API, and native Android app.
sonarrToRSSSelf-hosted open-source tool that converts Sonarr webhooks into RSS, Atom, and JSON feeds with a browsable web interface for historical events.
spotwebSelf-hosted Usenet community implementing the Spotnet protocol. Browse, filter, and download spots with Sabnzbd/NZBGet integration and Newznab API for automation tools.
StringerA self-hosted, open-source RSS reader in Ruby on Rails: no social features, just feeds, keyboard shortcuts, translations and a Fever-compatible API.
TelegramRSSTelegramRSS is a self-hosted, open-source microservice converting public Telegram channels to RSS/JSON feeds with media support and shared caching.
telepageTelepage is a self-hosted PHP app turning Telegram channels into searchable websites with real-time sync, AI tagging, full-text search, and themes on shared hosting.
Tiny Tiny RSSSelf-hosted, open-source web RSS/Atom reader and aggregator with folders, OPML, filters, plugins, themes and a JSON API; runs via Docker Compose with PostgreSQL.
0 comments