Skip to content
a-grahPublic

About

Self-hosted RSS bridge: polls sites without RSS feeds and serves a standard RSS 2.0 feed

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

rssBridge

A self-hosted Go web app that polls sites that don't offer RSS feeds, extracts article headlines, groups similar stories, and serves a standard RSS 2.0 feed for any reader (NetNewsWire, Reeder, etc.).

Runs as a single binary on localhost with no system dependencies.

Features

  • Scrapes homepages and extracts article links
  • Fetches per-article meta descriptions as summaries
  • Detects and surfaces native RSS feeds when a site has one
  • Groups similar stories using Jaccard title similarity
  • Serves a standard RSS 2.0 feed
  • Per-site fetch intervals and keyword exclusion filters
  • Background scheduler with configurable pruning
  • Dark-themed admin panel with manual "Fetch Now" controls

Requirements

  • Go 1.23+

No CGO. No system libraries. No external services.

Install

git clone https://github.com/a-grah/rssBridge
cd rssBridge
make build
./rssBridge

Open http://localhost:7171/admin.

Usage

./rssBridge [flags]

  --port  string   HTTP port (default: value in DB, fallback 7171)
  --db    string   Path to SQLite database (default: rssbridge.db)

Port can also be set via the RSSBRIDGE_PORT environment variable or through the Settings page in the admin panel.

Admin Panel

Path Description
/admin Dashboard — site statuses, recent fetches
/admin/sites Add, edit, and delete monitored sites
/admin/settings Global settings
/admin/log Full fetch history
/rss The RSS 2.0 feed

Adding a Site

  1. Go to Sites → Add New Site
  2. Enter a name and homepage URL (e.g. https://news.ycombinator.com)
  3. Set a fetch interval in hours (default 12)
  4. Optionally add comma-separated keywords to exclude (e.g. crypto, sponsored)
  5. Click Add Site & Fetch — a fetch runs immediately

Settings

Key Default Description
rss_title rssBridge Channel title in the RSS feed
rss_max_items 100 Max items in the feed
default_interval_hours 12 Default fetch interval for new sites
prune_after_days 30 Auto-delete articles older than N days (0 = off)
port 7171 HTTP server port

RSS Feed

Subscribe to http://localhost:7171/rss in your RSS reader.

If a monitored site has its own native RSS feed, rssBridge detects it and shows an advisory item in the feed with a direct link so you can subscribe to the source instead.

Dependencies

About

Self-hosted RSS bridge: polls sites without RSS feeds and serves a standard RSS 2.0 feed

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages