RSS

RSS is a simple, opinionated web application for aggregating RSS and Atom feeds and displaying them in a clean, social-feed-like interface. It focuses on lightweight configuration and a narrow feature scope, with a ready-to-run container image.

Key Features

• Supports both RSS and Atom feeds
• Automatic feed fetching on a schedule (hourly by default, configurable down to 5 minutes)
• Feed configuration via a single plaintext file (names, tags, colors, hidden feeds)
• Feed-level tags for categorization and filtering
• Multiple layout modes (card, list, compact) and system dark/light theme
• Open Graph thumbnail fetching for posts
• Search across post titles and descriptions
• Built-in pruning of old post data
• Mobile-friendly UI

Use Cases

• Personal or small-team feed reading with a clean web UI
• Lightweight “news wall” dashboard for curated sources
• Self-hosted replacement for basic RSS reader needs without accounts

Limitations and Considerations

• No built-in authentication/authorization or user management
• No UI-based feed management (feeds are edited in a text file)
• No full-article content import and limited error reporting

RSS is best suited for users who want a minimal, low-maintenance feed reader that is easy to deploy and manage. Pairing it with a reverse proxy is recommended when you need HTTPS or path-based routing.