RSS Feed Reader
by home-screensVerified·News & Finance·v1.0.0·Updated Jul 28, 2026
Follow any RSS, Atom, or JSON feed. Merge headlines from multiple sources into a list, compact, or rotating view.
About
Follow any RSS 2.0, RSS 1.0 (RDF), Atom, or JSON Feed source on your Home Screens display. Merge headlines from multiple feeds into one widget with list, compact, and rotating story views.

Features
- Any feed format — RSS 2.0, RSS 1.0/RDF, Atom 1.0, JSON Feed 1.x, auto-detected
- Multiple feeds, one widget — items are merged, deduped, and sorted newest first
- Three views — list (headlines with optional descriptions and thumbnails), compact (dense one-liners), rotator (one story at a time)
- Thumbnails — pulled from
media:thumbnail,media:content, image enclosures, or the first image in the story body - Resilient — one broken feed never blanks the widget; a subtle footer notes unavailable feeds
- Safe — feed content is never rendered as HTML; everything is sanitized to plain text
- Zero dependencies — parses with the browser's own
DOMParser; 14 kB bundle
Works with self-hosted aggregators too (FreshRSS, Miniflux, Tiny Tiny RSS): point a feed at your instance's RSS output URL. The localNetwork permission lets the proxy reach LAN addresses.
Screenshots
| Compact | Rotator |
|---|---|
![]() | ![]() |
Configuration
| Setting | Default | Notes |
|---|---|---|
| Feeds | none | URL + optional label per feed |
| Layout | List | List, Compact, or Rotator |
| Max stories | 8 | 1 to 20 across all feeds |
| Seconds per story | 8 | Rotator only |
| Show source / age / descriptions / thumbnails | varies | Per-detail toggles |
| Refresh interval | 10 min | How often feeds are re-fetched |
Development
npm install
npm test # vitest (jsdom)
npm run typecheck
npm run build # dist/bundle.js
npm run dev # watch build + serve on :5173 for host dev mode
Release
npm run build
mkdir -p /tmp/rss-pkg/rss-feed/dist
cp manifest.json /tmp/rss-pkg/rss-feed/
cp dist/bundle.js dist/bundle.js.map /tmp/rss-pkg/rss-feed/dist/
tar -czf plugin.tar.gz -C /tmp/rss-pkg rss-feed
shasum -a 256 plugin.tar.gz
License
MIT
Versions
1.0.0
Jul 28, 2026
Initial release: RSS, Atom, and JSON feeds merged into list, compact, or rotating views with optional source names, timestamps, descriptions, and thumbnails
Needs Home Screens 1.3.0 or newer

