# 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.

Canonical page: https://ourlocalhost.com/app/8047/html2rss

## Description

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: Any server.

## Health score

73/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 1 day ago)
- Popular: 46 (200 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 100 (no serious findings, CI, tests)

## Links

- Official website: https://html2rss.github.io/web-application/
- GitHub: https://github.com/html2rss/html2rss-web
- Documentation: https://html2rss.github.io/getting-started/

## 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.

## Alternatives

- 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

---
Source: Our Local Host (https://ourlocalhost.com/app/8047/html2rss), the self-hosted and open-source app directory.
