Transform any website into a RSS feed
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Amazed d48f2f5d5c Increased element field from 255 to 1000 characters 3 years ago
hrss Added X_FRAME_OPTIONS 3 years ago
web Increased element field from 255 to 1000 characters 3 years ago
.gitignore Revert .gitignore 3 years ago Updated README for Docker instructions (thank you @kmlucy) 4 years ago Init commit 4 years ago
requirements.txt Added logging, use html5lib instead of html.parser (better results overall), disallow adding feed with missing required fields 4 years ago


HRSS is an application that allows you to transform any website into a RSS feed.



  • Fill an URL in the homepage field then click Setup.
  • Click on a field on the left panel, then hover and select the element on the right panel. Setup
  • Fill at least the Element, Title and Content fields, then click on Generate.
  • Your RSS feed is ready and shown on the next page. Feeds


  • Free and open-source. No limits.
  • No complicated installation procedure (if you know how to setup a Django app).
  • No database needed (H2 file used).
  • Works for 80% of websites out there.
    • Why does it not work for every website? Mainly because Javascript on these websites do some obscure checks and do not permit iframes. Ideas of workarounds are welcome.
  • No user management at the moment (self-host your own instance and protect it with a basic auth if you want security).
  • Fully working in most RSS readers (I use Tiny Tiny RSS and it works great).


Because we all love demos.

Installation (native)

  1. Make sure you have Python3 installed and virtualenv.
  2. Clone this repo for unstable branch, or download latest release.
  3. cd hrss && python3 -m virtualenv --python=python3 .to create a new virtualenv.
  4. bin/activate && pip3 install -r requirements.txt to install dependencies.
  5. python3 migrate to apply latest DB migrations (and create the H2 database file).
  6. python3 runserver to run the integrated webserver (not suitable for production use - even though you should not use HRSS in a production environnement at all until it is considered stable anyway). Use uWSGI to run it in a production environnement.

Installation (Docker)

Use nicely made by kmlucy.