Skip to content

MarioGervais/open-airss

Repository files navigation

Open-AIRSS

A minimalist, self-hostable RSS reader for the web.

Open-AIRSS is an open-source web frontend for RSS aggregators that support the Google Reader API (FreshRSS, Miniflux, etc.). Clean interface, no tracking, no cloud, no nonsense.


Features

  • Three-panel reading interface (feeds / articles / content)
  • Light and dark theme
  • 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

Screenshots

Coming soon.


Getting Started

With Docker (recommended)

git clone https://github.com/your-username/open-airss.git
cd open-airss
cp .env.example .env
# Edit .env with your FreshRSS/Miniflux server URL
docker compose up -d

Then open http://localhost:3000 in your browser.

Manual install

npm install
npm run dev

Configuration

Copy .env.example to .env and fill in the values:

PUBLIC_API_URL=https://your-freshrss-instance.example.com

Compatible Backends

Backend API Status
FreshRSS Google Reader Supported
Miniflux Google Reader Supported
Nextcloud News Google Reader Supported
Tiny Tiny RSS Google Reader (plugin) Untested

Tech Stack

  • SvelteKit + TypeScript
  • CSS custom properties (no framework)
  • Docker + Nginx for production

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before submitting a pull request.


License

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.


Acknowledgements

Inspired by Miniflux and Reminiflux.

About

A minimalist, self-hostable RSS reader for the web

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors