Repolode
Athou

Athou/commafeed

A Google Reader-inspired, self-hosted personal RSS reader built on Quarkus and React/TypeScript.

Open-source alternative to:FeedlyInoreader

Stars
3,634
Forks
414
Open issues
44
Last commit
21 hours ago

What is it?

CommaFeed is a self-hosted RSS reader modeled on Google Reader. The backend runs on Quarkus in Java and the web client is written in React and TypeScript. The interface offers four layouts, light and dark themes, and a responsive design that works on both mobile and desktop. Most actions have keyboard shortcuts.

By default it uses an embedded H2 database, and it can also run on PostgreSQL, MySQL, or MariaDB. It supports OPML import and export, a REST API, and the Fever and Google Reader APIs so native mobile apps can sync with it. Users can define rules that automatically mark articles as read. Docker images, native executables, and JVM packages are available.

Key features

  • 01Four article layouts with light and dark themes
  • 02Responsive interface for mobile and desktop with keyboard shortcuts
  • 03Embedded H2 database, or PostgreSQL, MySQL, and MariaDB
  • 04OPML import and export
  • 05REST API plus Fever and Google Reader APIs for mobile clients
  • 06Rules that automatically mark articles as read

Use cases

  • Running a private RSS reader on your own server or home network
  • Syncing feeds with native mobile RSS apps through Fever or Google Reader compatible APIs
  • Migrating subscriptions from another reader via OPML

Quick start

  1. 1

    Run the official Docker image (see Docker section for image at Docker Hub)

  2. 2

    Open the app at the local address after startup

Things to know

  • Requires a Java build toolchain or Docker for self-hosting from source.
  • Native builds need GraalVM or a container runtime.

In collections

Topics

FAQ

What is commafeed?
A Google Reader-inspired, self-hosted personal RSS reader built on Quarkus and React/TypeScript. CommaFeed is a self-hosted RSS reader modeled on Google Reader. The backend runs on Quarkus in Java and the web client is written in React and TypeScript. The interface offers four layouts, light and dark themes, and a responsive design that works on both mobile and desktop. Most actions have keyboard shortcuts.
Is commafeed free to use? What license does it have?
commafeed is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is commafeed still maintained?
Actively maintained. The last commit to commafeed was on Oct 23, 2026.
What can I use commafeed for?
Running a private RSS reader on your own server or home network Syncing feeds with native mobile RSS apps through Fever or Google Reader compatible APIs Migrating subscriptions from another reader via OPML
How do I install commafeed?
Run the official Docker image (see Docker section for image at Docker Hub) Open the app at the local address after startup
Where can I get commafeed?
The source code and installation instructions are on GitHub: https://github.com/Athou/commafeed

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects