tinyfeed is a simple CLI tool that generates a lightweight, customizable static HTML page aggregating RSS, Atom, and JSON feeds—no database or config file needed—for self-hosters, developers, and tinkerers.

---

🚀 Overview

Explain the project in 2-4 short paragraphs.

tinyfeed is a minimalist Go CLI tool designed to create a single static HTML page from a list of RSS, Atom, or JSON feed URLs. It's dead simple: provide feeds via CLI or file, and it outputs fully-formed, accessible HTML ready to deploy anywhere.

What problem does this project solve? It addresses the bloat of modern feed readers—no logins, tracking, or in-app reading; just a clean, time-ordered list of links like Lobste.rs or Hacker News for quick scanning and original-site visits.

Who is it built for? Self-hosters, developers, and indie tinkerers wanting personal or shared feed dashboards without servers or databases.

Why did you build it? Out of frustration with complex alternatives; inspired by tinystatus and simple aggregators, built for easy cron/systemd integration since 2023.

Keep it human and honest.

---

✨ Key Features

• Aggregates RSS, Atom, JSON feeds via gofeed library (fetches/parses reliably across formats; enables broad feed support)
• Custom styling/templates/scripts (link external CSS/JS/HTML; full personalization without code changes)
• Auto dark/light themes per system prefs (enhances usability/accessibility)
• Daemon mode for scheduled updates (integrates with cron/systemd; keeps content fresh effortlessly) Optional: upcoming or experimental features like enhanced pipelining

---

🛠 Tech Stack

• Language: Go (statically compiled, cross-platform binaries)
• Feed Parser: gofeed
• Output: Static HTML (no backend)
• Database: None
• Auth: None
• Hosting: Any static host (GitHub Pages, Vercel, etc.)

---

👥 Who Is This For?

This project is useful for:

• Developers who want to build dead-simple feed aggregators without infra
• Teams looking for minimalist internal news feeds
• Indie makers building personal static sites with live content

---

📸 Screenshots / Demo

• Live demo: https://feed.lovergne.dev/demo
• GitHub: https://github.com/TheBigRoomXXL/tinyfeed

---

🔥 Project Status

• 🟢 Actively building

Last updated: 2025-07-27

---

❓ FAQ

Is this project free?

Yes / Open Source (Free to use, MIT licensed, binaries available.)

---

Is the source code available?

Yes — https://github.com/TheBigRoomXXL/tinyfeed No — explain why

---

Can I contribute?

Open GitHub issues for bugs/features/feedback. Submit PRs after discussion. Share your demos via MR to add to showcase.

---

📬 Contact & Links

• Website: https://feed.lovergne.dev
• GitHub: https://github.com/TheBigRoomXXL/tinyfeed
• Twitter/X:
• Email:

---

Built with ❤️ and kept warm on WarmIndex.