Skip to content

RSS-proxy allows you to do create an RSS or ATOM feed of almost any website, just by analyzing just the static HTML structure.

Notifications You must be signed in to change notification settings

damoeb/rss-proxy

Repository files navigation

RSS-proxy

RSS-proxy allows you to do create an RSS/ATOM or JSON feed of almost any website or feed, purely by analyzing just the HTML structure. Try the live demo. The server is completely stateless, everything is part of the url.

It is a UI for richRSS middleware and is shipped in a multiplatform docker image.

Playground

Quickstart using docker-compose

The simplest way to use RSS-proxy is using docker or podman. This will start rss-proxy and puppeteer

wget https://raw.githubusercontent.com/damoeb/rss-proxy/master/docker-compose.yml
docker-compose up

This will start rss-proxy and a headless chrome. Open localhost:8080 in the browser.

Features

  • Web to Feed
  • Dynamic rendering using headless chromium
  • Feed Format Conversion
  • Content Recovery using JSON-LD, OpenGraph and fulltext extraction
  • Filters
  • Security
  • Alerts if the feed transformation encounters problems
  • Privacy

Minimal Runtime

If you consider using rss-proxy just for static websites, do this:

docker pull damoeb/rss-proxy:2
docker run -e APP_PUBLIC_URL=http://localhost:8080 -e TOKEN_SECRET=1234_top_secret -p 8080:8080 -it damoeb/rss-proxy:2

Security

Every API access requires a signed token. Requests are throttled on IP level and token level.

Flags

Name Description
PUPPETEER_HOST -
LOG_LEVEL error
ENABLE_FULLTEXT true
TOKEN_SECRET To sign the JWTs -

Security

Changelog

See changelog.

Related Projects

License

This project uses the following license: GNU GPLv3.

About

RSS-proxy allows you to do create an RSS or ATOM feed of almost any website, just by analyzing just the static HTML structure.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 5