A minimalist, self-hostable feed reader for RSS, Atom and JSON Feed, backed by PostgreSQL.
- Stars
- 235
- Forks
- 39
- Open issues
- 36
- Last commit
- 10 days ago
What is it?
Leed (short for Light Feed) is an RSS and ATOM feed aggregator that you install on your own server. It is built in PHP and uses MySQL for storage, with Apache recommended as the web server.
Feed fetching and processing run in the background through a cron task, so opening the interface does not wait on each subscribed feed. The project can be triggered either by calling the PHP script locally or by requesting a synchronization URL with a wget call, which is protected by a sync code.
The interface is responsive and works on desktop, tablet and smartphone. Subscriptions can be imported and exported in the OPML format, and plugins are distributed through a separate Leed-market repository.
Key features
- 01Aggregates RSS and ATOM feeds in one reader interface.
- 02Runs feed updates in the background via cron.
- 03Imports and exports subscriptions in OPML format.
- 04Responsive layout for desktop, tablet and smartphone.
- 05Supports remote synchronization triggered by a protected URL.
Use cases
- Running a private feed reader on a personal web server or shared hosting.
- Migrating existing subscriptions from another reader using an OPML file.
- Following news and blogs without a third-party cloud account.
Quick start
- 1
Download the project archive from the GitHub releases page
- 2
Place the project in your web directory and set permissions (chmod 775)
chmod 775 - 3
Open install.php in your browser and follow the setup instructions, then delete install.php
- 4
Optionally schedule feed updates with cron (crontab -e)
0 * * * * cd (...)/leed && php action.php >> logs/cron.log 2>&1
Things to know
- Requires PHP 7.2 or later and MySQL.
- Apache is recommended; other web servers such as Nginx are untested.
- No license is specified in the project metadata.
In collections
Topics
FAQ
- What is Leed?
- Leed is a minimalist self-hosted RSS/ATOM feed reader that refreshes feeds via cron so pages load quickly. Leed (short for Light Feed) is an RSS and ATOM feed aggregator that you install on your own server. It is built in PHP and uses MySQL for storage, with Apache recommended as the web server.
- Is Leed free to use? What license does it have?
- Leed has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
- Is Leed still maintained?
- Actively maintained. The last commit to Leed was on Oct 28, 2026.
- What can I use Leed for?
- Running a private feed reader on a personal web server or shared hosting. Migrating existing subscriptions from another reader using an OPML file. Following news and blogs without a third-party cloud account.
- How do I install Leed?
- Download the project archive from the GitHub releases page Place the project in your web directory and set permissions (chmod 775): chmod 775 Open install.php in your browser and follow the setup instructions, then delete install.php Optionally schedule feed updates with cron (crontab -e): 0 * * * * cd (...)/leed && php action.php >> logs/cron.log 2>&1
- Where can I get Leed?
- The source code and installation instructions are on GitHub: https://github.com/LeedRSS/Leed
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Folo is an open-source AI RSS reader that puts all your feeds, newsletters, podcasts and social sources into one timeline.
A free, open-source RSS reader for macOS and iOS that supports RSS, Atom, JSON Feed and RSS-in-JSON.
A self-hostable PHP service that saves web articles into a personal RSS/Atom feed so you can read them later in any feed reader.
A self-hostable service that turns email newsletters into Atom feeds you can read in any feed reader.
A self-hosted RSS/Atom feed reader that runs as an app inside Nextcloud.