A small self-hosted service that turns web pages into RSS 2.0 feeds. Go rewrite (MVP) of the Ruby html2rss gem — see PROJECT.md for the charter and scope.

Status: V1 (auto-discovery of <link rel="alternate" type="application/rss+xml"> and proxied republishing).

docker compose up --build

Then open http://localhost:8180. Configs persist under ./data/feeds/*.yml.

go run ./cmd/html2rss

Defaults: listens on :8180, data dir ./data (override with HTML2RSS_ADDR and HTML2RSS_DATA_DIR).

The CI workflow at .github/workflows/docker.yml builds a linux/amd64 image on every push to main and on v* tags, and publishes to GHCR as ghcr.io/teejs/html2rss_go.

On the Unraid server:

1. Docker tab → Add Container.
2. Fill in:
   • Name: html2rss
   • Repository: ghcr.io/teejs/html2rss_go:latest
   • Network Type: bridge
   • Port mapping: Container 8180 (TCP) → Host 8180 (or whatever you want)
   • Path mapping: Container /data → Host /mnt/user/appdata/html2rss (Read/Write)
3. Apply. Unraid pulls the image and starts the container. UI at http://<unraid>:8180.

If you make the GHCR package private, log in once on the Unraid host:

echo <GHCR_PAT_with_read_packages_scope> | docker login ghcr.io -u <github_user> --password-stdin

To upgrade: in Unraid's Docker tab, click the html2rss container → Force update, or run docker pull ghcr.io/teejs/html2rss_go:latest && docker restart html2rss.

This service has no authentication by design (MVP). Do not expose to the public internet.