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.

List view: headlines from two feeds with thumbnails, source, age and a two-line description

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

CompactRotator
Compact view: dense one-line headlines with their ageRotator view: one story at a time with its picture

Configuration

SettingDefaultNotes
FeedsnoneURL + optional label per feed
LayoutListList, Compact, or Rotator
Max stories81 to 20 across all feeds
Seconds per story8Rotator only
Show source / age / descriptions / thumbnailsvariesPer-detail toggles
Refresh interval10 minHow 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