Create your own daily news reader from any public RSS feeds — no coding or servers required.
- 📰 Build your own personal news reader using any public RSS feeds
- 🧰 Use this template to create your own copy of the project
- ⚙️ Enable GitHub Pages to publish your feed as a static website
- ✅ Pick your sources and paste them into the config form
- 🛠 Save the generated JSON to feeds/feeds.json in your repo
- 🔁 Feed updates daily via GitHub Actions — no coding needed
- 📱 Mobile-friendly and runs entirely on GitHub
See it in action: News Feed Demo
Source: Template Repo
This tool is designed for individuals who:
- Want to stay up to date on news, research, or niche topics
- Prefer to choose their own sources
- Want to avoid email newsletters, ad tracking, or social media platforms
- Don’t know what RSS is (yet) :)
RSS is a simple way to get new articles from your favourite websites.
- It stands for Really Simple Syndication
- Many news and research sites quietly offer RSS feeds
- This project uses those feeds to build your own personal news site
Examples:
- A Google News search result like
https://news.google.com/rss/search?q=cybersecurity - A blog like
https://example.com/rss - A WordPress website
https://example.com/feed
No ads, no login, just headlines and links — all under your control.
- Displays the latest articles from the feeds you choose
- Lets you filter by:
- News source
- Time range (24h, 48h, 7d, or all time)
- Keywords (with AND, OR, and phrase support)
- Automatically updates once per day (8pm UTC)
- Fully hosted on GitHub Pages
- Mobile-friendly
- A GitHub account
- Comfort with editing text files in GitHub’s web interface
- Public RSS feeds (not login-protected unless you want to reveal your password to the world!)
No installs. No backend. Just GitHub + a web browser.
| Step | Action |
|---|---|
| 🧪 1 | Click "Use this template" (top right of this page) to create your own copy of this repo |
| ⚙️ 2 | Name your repository and enable GitHub Pages (Settings → Pages → GitHub Actions) |
| 🗂 3 | Visit https://yourusername.github.io/your-repo-name/config.html and use the Config form |
| 📝 4 | Paste the JSON into feeds/feeds.json and commit changes |
| 🔄 5 | Site updates automatically within 1–2 minutes |
| 🌐 6 | Visit your personal feed and apply filters |
| 🔖 7 | Bookmark the URL — filters are saved in the link |
The Detailed Setup Guide is located in the wiki.
You can keep several feed files in /feeds/. For example:
feeds/soccer.jsonfeeds/cybersecurity.jsonfeeds/recipes.json
The config tool (config.html) helps you generate valid content for each one.
+--------------+ +------------------+ +-------------------------+
| feeds/*.json | ----> | GitHub Actions | ---> | index.html (Static Feed) |
+--------------+ | Runs daily | +-------------------------+
| Runs main.py |
| Outputs HTML |
+------------------+
- Finding RSS feeds using Google or Bing
- How to convert Google News searches into RSS
- Example feeds.json snippets
main.pyreads all JSON files in/feeds/- It uses
feedparserto pull latest articles - Generates a single
index.htmllisting articles - GitHub Actions (
update_feed.yml) runs daily - GitHub Pages serves the result
-
Go to the Actions tab
-
Open the
Update News Feed Dailyrun -
Check the error. Most common issue:
JSONDecodeError: Illegal trailing comma
→ Remove the trailing comma in your .json config
- Track multiple sources on the same topic
- Filter results by time or keyword
- Stay updated without distractions
- Check once a day, just the headlines
Free to use, modify, or share.