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.
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
Variants
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
- html2rss - Convert a HTML web page to a RSS feed - Reddit (reddit)
- HTML 2 RSS Problem - Warrior Forum (forum)
Collected today - public community threads