1
0
forked from notBrad/bubo-rss
An irrationally minimalist, static feed reader (RSS, Atom, JSON) you can instantly deploy on Netlify, Glitch or your own server. Dockerized.
Go to file
2019-11-28 16:24:21 -08:00
.github Create FUNDING.yml 2019-11-27 18:27:47 -08:00
output Initial release 2019-11-27 18:17:45 -08:00
src added DEV.to to default feed list 2019-11-28 16:24:21 -08:00
.gitignore Initial release 2019-11-27 18:17:45 -08:00
netlify.toml Initial release 2019-11-27 18:17:45 -08:00
package-lock.json Initial release 2019-11-27 18:17:45 -08:00
package.json Initial release 2019-11-27 18:17:45 -08:00
README.md Merge branch 'master' of github.com:georgemandis/bubo-rss 2019-11-28 15:57:37 -08:00

🦉 Bubo Reader

Bubo Reader is a somewhat irrationally minimalist RSS and JSON feed reader you can deploy on Netlify in a few steps. The goal of the project is to generate a webpage that shows a list of links from a collection of feeds organized by category and website. That's it.

It is named after this silly robot owl from Clash of the Titans (1981).

You can read more about how this project came about in my blog post 'Introducing Bubo RSS: An Absurdly Minimalist RSS Feed Reader'

Getting Started

How to use Bubo Reader in a few easy steps with GitHub and Netlify:

Deploying from GitHub to Netlify

The deploy settings should automatically import from the netlify.toml file. All you'll need to do is confirm and you're ready to go!

Keeping Feeds Updated

To keep your feeds up to date you'll want to setup a Build Hook for your Netlify site and use another service to ping it every so often to trigger a rebuild. I'd suggeste looking into:

If you already have a server running Linux and some command-line experience it might be simpler to setup a cron job.

Anatomy of Bubo Reader

  • src/index.html - a Nunjucks template that lets you change how the feeds are displayed
  • output/style.css - a CSS file to stylize your feed output
  • src/feeds.json - a JSON file containing the URLs for various site's feeds separated into categories
  • src/index.js - the script that loads the feeds and does the actual parsinga and rendering

Support

If you found this useful please consider sponsoring me or this project. If you'd rather run this on your own server please consider using one of these affiliate links to setup a micro instance on Linode or Digital Ocean.