Repolode
Submit
html2rss

html2rss/html2rss-web

A self-hosted web app that turns almost any website into an RSS 2.0 or JSON Feed, with automatic item extraction.

View on GitHubWebsite
Stars
195
Forks
17
Open issues
8
Last commit
3 days ago

What is it?

html2rss-web lets you paste a page URL into a web interface and get back an RSS 2.0 or JSON Feed for it. Its auto-source mode extracts items from a page without hand-written CSS selectors, which suits listing, newsroom, changelog, and releases pages.

Sites that render content with JavaScript are handled by a companion botasaurus-scrape-api service that runs alongside the app. The same instance also serves a Feed Directory catalog of feed configurations.

The project is distributed as Docker Compose files, with a quickstart setup for evaluation and a production setup that uses an access token and a secret key. For public hosting, it can sit behind a reverse proxy such as Caddy, Nginx, or Traefik, or terminate TLS directly.

Key features

  • 01Turns a pasted page URL into an RSS 2.0 or JSON Feed.
  • 02Auto-source extracts items without hand-written selectors.
  • 03Handles JavaScript-rendered sites via a companion scraping service.
  • 04Ships Docker Compose files for quick evaluation and production deployment.
  • 05Supports custom feeds through a mounted YAML configuration file.
  • 06Can terminate TLS directly or run behind a reverse proxy.

Use cases

  • Following product changelogs or release pages that have no RSS feed.
  • Monitoring news or listing pages in a feed reader.
  • Self-hosting a feed generator for a small team on a LAN.
  • Creating custom feeds for sites that need specific selectors.

Quick start

  1. 1

    Download the quickstart compose file

    curl -O https://raw.githubusercontent.com/html2rss/html2rss-web/main/docker-compose.quickstart.yml
  2. 2

    Start the stack with Docker Compose

    docker compose -f docker-compose.quickstart.yml up -d
  3. 3

    Open http://localhost:4000/, enter the demo token CHANGE_ME_ADMIN_TOKEN, and paste a page URL to create a feed

Things to know

  • The quickstart uses development mode and a demo token, so use the production compose setup for permanent or public hosting.
  • Self-hosting needs Docker, generated secrets in .env, and a reverse proxy with TLS for public internet exposure.
  • JavaScript-rendered sites require the companion botasaurus-scrape-api service.

In collections

RSS readers and feed toolsSelf-hosted apps

Topics

#rss#web-scraping#feed-generator#docker#ruby#self-hosted#json-feed#builder#feed#feed-configs

FAQ

What is html2rss-web?
A self-hosted web app that turns almost any website into an RSS 2.0 or JSON Feed, with automatic item extraction. html2rss-web lets you paste a page URL into a web interface and get back an RSS 2.0 or JSON Feed for it. Its auto-source mode extracts items from a page without hand-written CSS selectors, which suits listing, newsroom, changelog, and releases pages.
Is html2rss-web free to use? What license does it have?
html2rss-web is open source under the MIT license. Check the license terms before using it in commercial products.
Is html2rss-web still maintained?
Actively maintained. The last commit to html2rss-web was on Nov 4, 2026.
What can I use html2rss-web for?
Following product changelogs or release pages that have no RSS feed. Monitoring news or listing pages in a feed reader. Self-hosting a feed generator for a small team on a LAN. Creating custom feeds for sites that need specific selectors.
How do I install html2rss-web?
Download the quickstart compose file: curl -O https://raw.githubusercontent.com/html2rss/html2rss-web/main/docker-compose.quickstart.yml Start the stack with Docker Compose: docker compose -f docker-compose.quickstart.yml up -d Open http://localhost:4000/, enter the demo token CHANGE_ME_ADMIN_TOKEN, and paste a page URL to create a feed
Where can I get html2rss-web?
The source code and installation instructions are on GitHub: https://github.com/html2rss/html2rss-web

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects