A self-hosted RSS feed aggregator with multi-user support, a Google Reader-compatible API for mobile apps, and XPath-based web scraping.
- Stars
- 2,214
- Forks
- 91
- Open issues
- 19
- Last commit
- last month
What is it?
Fusion is a self-hosted RSS and Atom reader that runs as a single binary or in Docker. It handles feed parsing, automatic feed discovery, and organizing subscriptions into groups, with a reading workflow built around unread tracking, bookmarks, search, and Google Reader-style keyboard shortcuts.
Beyond its own web interface, Fusion implements the Fever API, so mobile and desktop clients such as Reeder, Unread, and FeedMe can sync with it. The web UI is responsive and installable as a PWA. Authentication is password-based by default, with optional OIDC single sign-on.
Feed pulling is configurable through environment variables for interval, timeout, concurrency, and backoff. The project includes no AI features by design, and its interface is available in eight languages including English and Simplified Chinese.
Key features
- 01Unread tracking, bookmarks, and full-text search for articles
- 02Google Reader-style keyboard shortcuts
- 03RSS/Atom parsing with feed auto-discovery and group organization
- 04Fever API compatibility for third-party clients
- 05Responsive web UI with PWA support
- 06Deployable as a single binary or via Docker, with optional OIDC login
Use cases
- Running a personal feed reader on a home server or VPS
- Reading feeds in a mobile app such as Reeder or FeedMe while keeping data on your own server
- Sharing a self-hosted reader with a small team behind SSO
- Following news and blogs without algorithmic recommendations or AI summaries
Quick start
- 1
Download the binary for your platform from the Releases page
- 2
Make the binary executable
chmod +x fusion - 3
Set a password and start Fusion
FUSION_PASSWORD="fusion" ./fusion - 4
Open http://localhost:8080 in your browser
Things to know
- The README's example password is "fusion", so you must set a stronger FUSION_PASSWORD for any real deployment.
- The project asks users to report bugs and propose features through issues and does not want pull requests.
In collections
Topics
FAQ
- What is fusion?
- A lightweight, self-hosted RSS reader with a responsive web UI, PWA support, and Fever API compatibility for third-party clients. Fusion is a self-hosted RSS and Atom reader that runs as a single binary or in Docker. It handles feed parsing, automatic feed discovery, and organizing subscriptions into groups, with a reading workflow built around unread tracking, bookmarks, search, and Google Reader-style keyboard shortcuts.
- Is fusion free to use? What license does it have?
- fusion is open source under the MIT license. Check the license terms before using it in commercial products.
- Is fusion still maintained?
- Updated within 6 months. The last commit to fusion was on Oct 7, 2026.
- What can I use fusion for?
- Running a personal feed reader on a home server or VPS Reading feeds in a mobile app such as Reeder or FeedMe while keeping data on your own server Sharing a self-hosted reader with a small team behind SSO Following news and blogs without algorithmic recommendations or AI summaries
- How do I install fusion?
- Download the binary for your platform from the Releases page Make the binary executable: chmod +x fusion Set a password and start Fusion: FUSION_PASSWORD="fusion" ./fusion Open http://localhost:8080 in your browser
- Where can I get fusion?
- The source code and installation instructions are on GitHub: https://github.com/0x2E/fusion
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Self-hosted PHP web app that aggregates RSS feeds and other sources into one reader with a live stream view.
A self-hosted RSS reader with smart folders, semantic event grouping, and a three-pane reading interface, built with Vue and Express.
Self-hosted news reader that automatically tags feed entries with LLMs and lets you score and filter news by those tags.
A free, self-hostable, web-based RSS/Atom feed reader and aggregator, a continuation of the tt-rss project.
A Go CLI that turns a list of RSS, Atom or JSON feeds into a single static HTML page you can host anywhere.