Welcome

tinyfeed is a CLI tool that generate a static HTML page from a collection of feeds.

It's dead simple, no database, no config file, just a CLI and some HTML

Give it a list of RSS, Atom or JSON feeds urls and it will generate a single HTML page for it. Then you can effortlessly set it up in crond, systemd or openrc and voilà, you’ve got yourself a webpage that aggregates your favorite feeds.

Feature

• RSS, Atom and JSON feeds are all supported thanks to the awesome gofeed library
• Highly customizable, especially with the ability to use external stylesheets and templates.
• Dark / Light theme based on system preference
• The generated page is lightweight and fully accessible.
• Supports a daemon mode to re-generate the output periodically.

Live demos

Default tinyfeed: feed.lovergne.dev/demo
With solarize theme : feed.lovergne.dev/demo/solarized
With lobste.rs skin : feed.lovergne.dev/demo/lobster
With hacker new skin : feed.lovergne.dev/demo/hackernew
With a back-to-top button injected: feed.lovergne.dev/demo/back-to-top

Screenshots

Visited links are in yellow, unvisited in blue.

Documentation

For guidance on installation, usage, customization and integration of tinyfeed, please checkout the documentation website

To get started:

• Installation guide
• Usage Guide

Feedback, help or bug report

If you need anything related to this project, whether it's just giving feedback, requesting a feature, or simply asking for help to understand something, open an issue on the official repository.

You have created a page with tinyfeed and you want to share it? You can open a merge request or an issue to add it to the demo section.

If you want to contribute, read CONTRIBUTING.md first so that we can collaborate efficiently.

Acknowledgement

Thank you @MariaLetta for the awesome free-gophers-pack which I adapted for the banner.

The project was heavily inspired by the awesomely simple tinystatus and message boards like Lobste.rs and Hacker News.