A minimalist, self-hostable feed reader for RSS, Atom and JSON Feed, backed by PostgreSQL.
- Stars
- 386
- Forks
- 21
- Open issues
- 9
- Last commit
- 19 days ago
What is it?
tinyfeed takes a list of RSS, Atom or JSON feed URLs and generates a single static HTML page that aggregates their entries. It needs no database and no configuration file, only the CLI and the HTML it produces.
The generated page can be refreshed by running the tool from cron, systemd or openrc, or by using its built-in daemon mode to regenerate the output periodically. Feed parsing is handled by the gofeed library. Styling can be changed with external stylesheets and templates, and the page follows the system's dark or light preference.
The project is aimed at people who want a personal, lightweight feed reader page that they can serve as plain files.
Key features
- 01Supports RSS, Atom and JSON feeds
- 02Generates a single static HTML page with no database
- 03Customizable through external stylesheets and templates
- 04Dark and light themes that follow system preference
- 05Daemon mode for periodic regeneration
Use cases
- Running a personal start page that aggregates blogs and news sites
- Publishing a shared feed page for a team or community
- Scheduling page updates with cron or systemd on a small server
Quick start
- 1
Follow the installation guide on the official documentation website
In collections
Topics
FAQ
- What is tinyfeed?
- A Go CLI that turns a list of RSS, Atom or JSON feeds into a single static HTML page you can host anywhere. tinyfeed takes a list of RSS, Atom or JSON feed URLs and generates a single static HTML page that aggregates their entries. It needs no database and no configuration file, only the CLI and the HTML it produces.
- Is tinyfeed free to use? What license does it have?
- tinyfeed is open source under the MIT license. Check the license terms before using it in commercial products.
- Is tinyfeed still maintained?
- Actively maintained. The last commit to tinyfeed was on Oct 20, 2026.
- What can I use tinyfeed for?
- Running a personal start page that aggregates blogs and news sites Publishing a shared feed page for a team or community Scheduling page updates with cron or systemd on a small server
- How do I install tinyfeed?
- Follow the installation guide on the official documentation website
- Where can I get tinyfeed?
- The source code and installation instructions are on GitHub: https://github.com/TheBigRoomXXL/tinyfeed
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A free, open-source RSS reader for macOS and iOS that supports RSS, Atom, JSON Feed and RSS-in-JSON.
A self-hosted RSS feed aggregator with multi-user support, a Google Reader-compatible API for mobile apps, and XPath-based web scraping.
Self-hosted PHP web app that aggregates RSS feeds and other sources into one reader with a live stream view.
A lightweight, self-hosted RSS reader with a responsive web UI, PWA support, and Fever API compatibility for third-party clients.
A self-hosted RSS reader with smart folders, semantic event grouping, and a three-pane reading interface, built with Vue and Express.