# html2rss

> Self-hosted web app turning webpages into RSS/JSON feeds. Paste a URL, get a feed instantly with a JS scraper. Includes Feed Directory and custom YAML support.

- **Category:** Feed Reader
- **Licence:** MIT
- **Latest version:** v1.14.5
- **Open source:** oss
- **Languages:** Typescript, Ruby
- **Platforms:** Docker Compose
- **Tags:** RSS, Web feeds, Json Feed, Docker, Ruby, Self Hosted, Scraper, Rss Feed, Rss Aggregator, Feed generator, Web scraper, Builder, Roda, Html2rss, Website Scraper, Rss Feed Scraper, Html2rss Configs, Rolling Release, Feed Configs, Webfeeds, Serves, Webfeed, URL To RSS, Feed Directory

## Description

html2rss-web is a self-hosted web application that transforms webpages into RSS 2.0 or JSON feeds. Users enter a URL in the browser interface and the auto-source feature pulls feed items without manual selector creation. A companion botasaurus-scrape-api service processes JavaScript-heavy sites. The same deployment also provides a Feed Directory catalog. It runs via Docker Compose with the main web app on port 4000 and the scraper on port 4010. Configuration relies on environment variables for required secrets such as session encryption and access tokens. Capabilities include automatic feed creation, Feed Directory API, custom YAML feed mounting, OpenAPI documentation, health check endpoints, rate limiting, and optional Sentry integration. The project uses the MIT license and receives regular releases.

## Links

- [Homepage](https://github.com/html2rss/html2rss-web)
- [Website](https://html2rss.github.io/web-application/)
- [Docker](html2rss/web)
- [GitHub Repository](https://github.com/html2rss/html2rss-web)
- [Discussions](https://github.com/orgs/html2rss/discussions)
- [Feed Directory](https://html2rss.github.io/feed-directory/)
- [Docker Hub](https://hub.docker.com/r/html2rss/web)
- [Contributing Guide](https://html2rss.github.io/get-involved/contributing)
- [Creating Custom Feeds](https://html2rss.github.io/creating-custom-feeds/)

---
Source: https://selfhost.directory/project/html2rss