RSS Reader

A modern RSS feed reader built with Node.js, EJS templating, SQLite database, and Tailwind CSS.

Features

• Feed Management: Add, edit, and delete RSS feeds via a settings modal
• Aggregated View: View all items from all feeds in one place via the "All" feed
• Feed Sidebar: Browse individual feeds with unread counts
• Folders: Group feeds into collapsible folders with Font Awesome icons, unread badges, and persistent collapse state
• Visual Indicators:
  • Colored left border on cards indicates the source feed
  • Gray border for read items
  • Feed icons displayed in sidebar and on cards
• Item Cards:
  • Display article title, description, and images
  • Clickable to open in new tab
  • Mark as read/unread functionality
• Full Content Fetching: Option to fetch and read full article content directly within the feed reader
• Mobile Responsive: Sidebar with hamburger menu toggle for mobile devices
• Progressive Web App (PWA): Installable web app
• Mark as Read by Scroll: Articles are automatically marked as read when scrolled out of view
• Auto Image Extraction: Automatically extracts images from RSS feeds
• Favicon Support: Auto-fetches feed icons or use custom icon URLs
• Auto Color Detection: Automatically extracts dominant color from feed icon (server-side, no CORS issues)
• Smart Icon Detection: Automatically detects icon when you enter feed URL
• Auto-Refresh: Feeds automatically refresh every 30 minutes via cron job. Articles older than the configured maximum age (default: 3 days) are automatically removed.
• Keyword Filtering: RSS entries containing these keywords in their title or url will be filtered out and not added to the database.
• Dark Mode: Toggle between light and dark themes with persistent preference
• Typography Merriweather Font: Uses the Merriweather font for improved readability

Screenshots

Mobile view of RSS Reader	Desktop view of RSS Reader
	Expanded article
	Light desktop view of RSS Reader

Tech Stack

• Backend: Node.js + Express
• Templating: EJS
• Database: SQLite (better-sqlite3)
• RSS Parsing: rss-parser
• Full Content Fetching: article-extractor
• Image Processing: Jimp (for color extraction) + icojs (for .ico conversion)
• HTTP Client: Axios (for fetching icons)
• Styling: Tailwind CSS (with dark mode)
• Scheduling: node-cron (for auto-refresh)
• Development: Nodemon + Concurrently

Installation

Using Docker Compose (Recommended)

docker-compose up -d

The application will be available at http://localhost:6789

Development Mode (Manual)

npm run dev

Production Mode (Manual)

# Build CSS
npm run build:css

# Start server
npm start

The application will be available at http://localhost:3000

Environment Variables

You can configure the application using the following environment variables:

• PORT - Port number for the application (default: 3000)
• NODE_ENV - Environment mode (development/production)
• MAX_ARTICLE_AGE_DAYS - Maximum age in days for articles. Articles older than this will be automatically removed during the scheduled refresh (default: 3)
• TZ - Timezone for the container (e.g., Europe/Berlin)

Example .env file

PORT=3000
NODE_ENV=production
MAX_ARTICLE_AGE_DAYS=7
TZ=Europe/Berlin

License

MIT