How to set up RSSMonster with Docker?

Use the Docker run command from the README, but note it requires an external MySQL database; configure environment variables for DB connection, and use --add-host for Linux/WSL to link to the host database.

Does RSSMonster work with Reeder on iOS?

Yes, via Fever API compatibility. Set the Fever endpoint in Reeder to your RSSMonster instance's API URL (e.g., http://your-url/api/fever) and use your RSSMonster credentials for authentication.

RSSMonster vs FreshRSS: which is better for self-hosting?

RSSMonster excels with AI-driven ranking and semantic clustering for noise reduction, while FreshRSS is simpler and PHP-based. Choose RSSMonster for advanced prioritization, but expect more setup with Node.js and MySQL.

Can RSSMonster summarize articles automatically?

Yes, through the AI-powered assistant using Model Context Protocol, which can summarize and classify articles based on quality scores, but it requires enabling the agent and configuring OpenAI API keys.

What's the difference between event clusters and topic groups?

Event clusters group articles about the same concrete event, while topic groups relate multiple events under a broader storyline, as explained in the semantic clustering feature to reduce duplicate coverage at different detail levels.

How to import feeds from Feedly to RSSMonster?

Export your feeds as OPML from Feedly, then use RSSMonster's OPML import feature via the UI or API to migrate subscriptions, maintaining categories and feed lists for seamless transition.

Is there a mobile app for RSSMonster?

No native app, but it's a Progressive Web App (PWA) that can be installed on devices for an app-like experience with offline support, accessible through modern browsers on iOS and Android.

Open-Awesome

RSS Monster

MITJavaScriptv2.2.0Self-Hosted

A self-hosted, intelligent RSS reader with semantic clustering, quality scoring, and Fever/Google Reader API compatibility.

Visit Website GitHub

502 stars45 forks0 contributors

What is RSS Monster?

RSSMonster is a self-hosted, intelligent RSS reader designed to combat information overload. It goes beyond simple feed aggregation by using semantic clustering, quality analysis, and customizable ranking algorithms to surface the most relevant and high-quality content. It offers API compatibility with popular clients and can be fully controlled via declarative search expressions.

Target Audience

Users who want a private, self-hosted RSS reader with advanced filtering and prioritization capabilities, especially those migrating from services like Feedly or Inoreader. It's also for developers who want to integrate with RSS clients via the Fever or Google Reader APIs.

Value Proposition

Developers choose RSSMonster for its unique combination of intelligent, transparent content ranking, full data ownership through self-hosting, and broad client compatibility. Its declarative Smart Folders and explainable algorithms offer a level of control and customization not found in most RSS readers.

Overview

Modern, self-hosted RSS reader with smart folders, powerful search, and a clean three-pane reading experience. Built with Vue and Express.

Use Cases

Best For

Self-hosting a private RSS reader to maintain data ownership
Reducing noise from duplicate news coverage via semantic clustering
Prioritizing reading lists with transparent, quality-based ranking
Using popular mobile RSS clients (like Reeder) with a self-hosted backend
Creating custom RSS feeds from filtered and curated article collections
Automating feed management with regex-based rules and AI assistance

Not Ideal For

Users seeking a fully managed, cloud-based RSS service with no server administration
Projects requiring only basic, chronological feed aggregation without advanced ranking or clustering
Environments with strict resource constraints where running a Node.js and MySQL stack is impractical
Teams needing plug-and-play deployment without database migrations or manual crawl setup

Pros & Cons

Pros

Transparent Intelligent Ranking

Uses a clear, explainable importance score blending freshness, quality, uniqueness, and feed trust, allowing users to adjust priorities via Smart Folders, as detailed in the ranking explanation.

Advanced Semantic Clustering

Groups similar articles into event clusters and topic groups to reduce duplicate coverage noise, with manual reclustering commands available for fine-tuning, as described in the semantic deduplication feature.

Flexible Client Compatibility

Supports Fever API and Google Reader API, enabling integration with popular RSS clients like Reeder and News+ without vendor lock-in, with documented endpoints and authentication.

Declarative Smart Folders

Allows creation of dynamic views using composable search expressions (e.g., 'Top Stories Today'), offering customizable filtering beyond fixed tabs, as shown in the Smart Folders examples.

AI-Powered Assistance

Integrates Model Context Protocol for natural language search and article summarization, though it requires OpenAI API keys and configuration, as noted in the AI assistant section.

Cons

Complex Initial Setup

Requires separate configuration for client and server, database migrations with Sequelize, and optional steps like feed crawling and cluster rebuilding, making deployment more involved than turnkey solutions.

External AI Dependency

AI features rely on OpenAI API keys and specific models (e.g., GPT-5.1), adding cost and external service reliance that contradicts the self-hosting philosophy for some users.

Manual Maintenance Overhead

Needs periodic manual commands for tasks like recalculating feed trust scores or rebuilding clusters, which aren't fully automated and require cron jobs or script execution.

Limited Database Support

Primarily designed for MySQL with 'configuration adjustments' for others, lacking built-in support for lightweight alternatives like SQLite, which could simplify setup for small deployments.

Open Source Alternative To

RSS Monster is an open-source alternative to the following products:

Inoreader

Inoreader is a content aggregation and RSS feed reader that allows users to follow websites, blogs, and news sources in a unified interface.

Feedly

Feedly is a news aggregator application that compiles news feeds from various online sources for users to customize and read in a single interface.

Frequently Asked Questions

Related Projects

RSS-Bridge

The RSS feed for websites missing it

Stars9,218

Forks1,244

Last commit10 days ago

Stringer

A self-hosted, anti-social RSS reader.

yet another rss reader

Stars4,044

Forks293