FreshRSS / FreshRSS
git clone https://github.com/FreshRSS/FreshRSS.git
1.30.2 · 1d ago
🔥 on GitHub Trending today
A self-hosted RSS feed aggregator web application with multi-user support, a mobile-compatible API, and a CLI.
Why you might care
Suited to people who want to run their own feed reader on a small server, including a Raspberry Pi. It supports WebSub push notifications, XPath-based scraping for sites without feeds, JSON feeds, and login via web form, HTTP auth, or OpenID Connect.
+8
stars, 24h · #1,667
+~56
stars, 7 days · #2,123
+302
stars, 30 days · #1,689
16k
★ total · +0% this week
1.3k
forks · 689 open issues
Star history (as recorded here)
LanguagePHP
LicenseAGPL-3.0
Created2012-10-21 (14y ago)
Last push1d ago
Watchers119
OwnerOrganization
Seen on GitHub Trending
- 2026-10-21 — #2 daily in php · +18 ★
- 2026-10-21 — #15 monthly in php · +302 ★
- 2026-10-20 — #2 daily in php · +13 ★
- 2026-10-20 — #15 monthly in php · +300 ★
GitHub topics
Links
- GitHub: github.com/FreshRSS/FreshRSS
- Homepage: https://freshrss.org
- Releases · Issues · Hacker News mentions
README excerpt
* Read this document on github.com/FreshRSS/FreshRSS/ to get the correct links and pictures. * Version française # FreshRSS FreshRSS is a self-hosted RSS feed aggregator. It is lightweight, easy to work with, powerful, customizable, and has been translated into many languages. It is a multi-user application with an anonymous reading mode. It supports custom tags. There is an API for (mobile) clients, and a Command-Line Interface. Thanks to the WebSub standard, FreshRSS is able to receive instant push notifications from compatible sources, such as Friendica, WordPress, Blogger, Medium, etc. FreshRSS natively supports basic Web scraping, based on XPath, for Web sites not providing any RSS / Atom feed. Also supports JSON documents. FreshRSS offers the ability to reshare selections of articles by HTML, RSS, and OPML. Different login methods are supported: Web form (including an anonymous option), HTTP Authentication (compatible with proxy delegation), OpenID Connect. Finally, FreshRSS supports extensions for further tuning. * Official website: * Demo: * License: GNU AGPL 3 ## Feedback and contributions Feature requests, bug reports, and other contributions are welcome. The best way is to open an issue on GitHub. We are a friendly community. To facilitate contributions, the following option is available: ## Screenshot ## Disclaimer FreshRSS comes with absolutely no warranty. # Documentation * User documentation, where you can discover all the possibilities offered by FreshRSS * Administrator documentation for detailed installation and maintenance related tasks * Developer documentation to guide you in the source code of FreshRSS and to help you if you want to contribute * Contributor guidelines for those who want to help improve FreshRSS * Check `AGENTS.md` for coding conventions (both for humans and AI agents). # Requirements * A recent browser like Firefox / IceCat, Edge, Chromium / Chrome, Opera, Safari. * Works on mobile (except a few features) * Light server running Linux or Windows * It even works on Raspberry Pi 1 with response time under a second (tested with 150 feeds, 22k articles) * A Web server: Apache2.4+ (recommended), nginx, lighttpd (not tested on others) * PHP 8.1+ * Required extensions: cURL, DOM, JSON, XML, session, ctype * Recommended extensions: PDO_SQLite (for export/import), GMP (for API access on 32-bit platforms), IDN (for Internationalized Domain Names), mbstring (for Unicode strings), iconv (for charset conversion), ZIP (for import/export), zlib (for compressed feeds) * Extension for database: PDO_PGSQL or PDO_SQLite or PDO_MySQL * PostgreSQL 10+ or SQLite or MariaDB 10.6+ or MySQL 8.0+ # Installation If you want a rolling release with the newest features and security fixes, or want to help testing or developing the next release, you can use the `edge` branch. If you prefer fewer updates, you can use the `latest` branch. It is more stable but at the price of less security and more known bugs, as fixes are not backpor
Blurb generated by claude-haiku-5-5 today. Star deltas marked ~ are extrapolated from partial history.