Skip to content

RSS Workshop

Self-hosted RSS and Atom feeds for websites that don’t provide them.

Build a feed by clicking on the page or with CSS and XPath selectors, render JavaScript sites with Chromium, filter the stories, and subscribe with any reader. It runs on your own machine, with no account and no third-party service.

Get started Try it on the demo site

RSS Workshop dashboard in dark mode, listing two feeds with their status, schedule and reader links

What it does

  • Click to choose, then fine-tune


    Click a repeating card, then its title, link, image and date. CSS and XPath sit side by side with live match highlighting.

    Visual selection

  • JavaScript pages


    Sandboxed Chromium renders pages that need a browser, and an optional external FlareSolverr handles challenge pages.

    Chromium rendering

  • The article, not the teaser


    Follow each story’s link and publish the full article, with cleanup rules for share bars and other clutter.

    Full article content

  • Feeds as sources too


    Read an existing RSS or Atom feed to filter it, or to publish its full articles behind one private link.

    Feed sources

  • Keep what you want


    Include and exclude rules with nested groups and bulk keyword lists, and a filter library to reuse rules across feeds.

    Story filters

  • Feeds that stay put


    RSS and Atom with stable item identities and dates, served from saved stories, plus an OPML export of every feed.

    RSS and Atom output

  • Know when a feed breaks


    The library points out feeds gone quiet, with per-feed diagnostics, Prometheus metrics and optional notifications.

    Monitoring

  • Recipes that travel


    Export a feed’s setup as a JSON recipe, import it elsewhere, or duplicate a feed to try other selectors without touching it.

    Recipe export and import

  • Yours to run


    MIT licensed. Docker Compose or a single Linux executable, SQLite or PostgreSQL, behind your own proxy or VPN.

    Deployment

Your first feed

  1. Install it. A few commands start the Docker image, which includes Chromium and SQLite; a standalone Linux executable works too.
  2. Build a feed. Choose New feed, enter a page, choose its elements visually, and preview exactly what a reader will receive.
  3. Subscribe. Copy the RSS or Atom link into your reader. Readers are served saved stories, so a slow or broken site never stalls them.

Install and build a first feed

No site in mind yet? These pages publish a small demo newspaper to practise on, with ready-made recipes for it: see example recipes and demo site.

A closer look

Screenshots use sample feeds.

Find your way