HTML2RSS

HTML2RSS is a self-hosted web app that converts web page URLs into RSS 2.0 or JSON Feed for users who need feeds from sites that do not provide them.

  • Development
HTML2RSS is a self-hosted web app that converts web page URLs into RSS 2.0 or JSON Feed for users who need feeds from sites that do not provide them.

Platform availability

Available on 1 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

73/100 Good

Maintained
100last commit 1 day ago
Popular
46200 GitHub stars
Easy to install
251 install platform, install notes
Light to run
No data
Security check
100no serious findings, CI, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
200
Open issues
11
Last commit
2026-11-20
Latest release
v1.17.0
License
MIT
Activity
declining

Checked today - source: GitHub (html2rss/html2rss-web)

Resources & Compatibility

Requirements not published yet.

Checked today - source: Docker Hub image tags and published docs

First-install notes

  • Browserless needs two settings If the site you are scraping is built with JavaScript, add --strategy browserless and set the BROWSERLESS_IO_WEBSOCKET_URL and BROWSERLESS_IO_TOKEN environment variables (name/value settings passed to the command). They tell html2rss where to find a real browser and how to use the service, so it can load the page the way a visitor sees it and return items. source
  • Keep your YAML feed file safe If you use a YAML file like feeds/all.yml to list your feeds, back it up and be careful with indentation. YAML is strict, so one misplaced colon or wrong space can make all feeds in that file fail to build. source
  • Set the Botasaurus address if you use it Botasaurus is an optional web-page fetching service. Set BOTASAURUS_SCRAPER_URL to its address before running html2rss, or it may not know where to get pages and your feed can stay empty. source
  • Quickstart Use the provided docker-compose.quickstart.yml, start the stack with Docker Compose, open localhost:4000, and use CHANGE_ME_ADMIN_TOKEN when prompted. source

Fetched today - each note links to its source

Alternatives (8)

  • Awesome-space
  • Distill Web Monitor - Distill is a web monitoring tool.
  • Feedbin - Feedbin is a modern web reader to follow websites, Twitter feeds and email newsletters in one place.
  • Miniflux - Miniflux is a minimalist, self-hosted RSS (Really Simple Syndication) and Atom feed reader.
  • Newsboat - Newsboat is a fork of Newsbeuter, an RSS/Atom feed reader for the text console.
  • Portia
  • WebSite-Watcher - WebSite-Watcher detects website updates and highlights all changes in the text.
  • Yarr

Checked today - source: AlternativeTo

Common questions

What secrets should I generate for a production html2rss-web deployment?

Generate a HTML2RSS_SECRET_KEY with at least 32 characters and a HTML2RSS_ACCESS_TOKEN with at least 16 characters. The quickstart admin token is only for evaluation.

Which ports should I expose when self-hosting html2rss-web?

html2rss-web can be exposed on port 4000 for the UI, while botasaurus should stay on the Compose network or be bound to 127.0.0.1:4010. For public access, terminate TLS with Caddy, Nginx, or Traefik and forward to port 4000.

How can I scrape pages that depend on JavaScript?

Add --strategy browserless and set BROWSERLESS_IO_WEBSOCKET_URL and BROWSERLESS_IO_TOKEN. These connect html2rss to a Browserless service so it can load rendered pages.

What should I watch out for when using a YAML feed file?

Back up the YAML feed file and keep its indentation valid. A misplaced colon or wrong space can make all feeds in that file fail to build.

Can I create feeds without using the web UI?

The web app exposes an access-controlled create API and provides OpenAPI.

Answers sourced from context7.com, github.com, html2rss.github.io

Community

Collected today - public community threads