A minimalist web frontend for self-hosted RSS aggregators.
Open-AIRSS is an open-source reading interface for any RSS aggregator that supports the Google Reader API (FreshRSS, Miniflux, etc.). Clean interface, no tracking, no cloud, no nonsense.
- Three-panel reading interface (feeds / articles / content)
- 6 themes — 3 dark (Catppuccin Mocha, Tokyo Night, Rosé Pine) and 3 light (Catppuccin Latte, One Light, Flexoki Light)
- 10 font choices, persistent across sessions
- Full keyboard navigation
- Compatible with any Google Reader API backend (FreshRSS, Miniflux, Nextcloud News...)
- Docker-ready — one command to deploy
- No telemetry, no third-party requests
Coming soon.
git clone https://github.com/MarioGervais/open-airss.git
cd open-airss
cp .env.example .env
# Edit .env with your FreshRSS/Miniflux server URL
docker compose up --build -dThen open http://localhost:3000 in your browser.
npm install
npm run devCopy .env.example to .env and fill in the values:
PUBLIC_API_URL=https://your-freshrss-instance.example.comNote: In the login form, use your FreshRSS API password — not your regular login password. You can find it under your FreshRSS profile settings.
| Backend | API | Status |
|---|---|---|
| FreshRSS | Google Reader | Supported |
| Miniflux | Google Reader | Supported |
| Nextcloud News | Google Reader | Supported |
| Tiny Tiny RSS | Google Reader (plugin) | Untested |
- SvelteKit + TypeScript
- CSS custom properties (no framework)
- Docker + Node.js for production
Contributions are welcome. Please read CONTRIBUTING.md before submitting a pull request.
GNU Affero General Public License v3.0
You are free to use, modify, and distribute this software under the terms of the AGPL-3.0. Any modifications deployed over a network must also be released under the same license.
Inspired by Miniflux and Reminiflux.