Readflow

Readflow is a lightweight, privacy-focused RSS reader and read-later app that gathers articles from your feeds and webhooks into one centralized flow.

  • Productivity
Readflow is a lightweight, privacy-focused RSS reader and read-later app that gathers articles from your feeds and webhooks into one centralized flow. You can save articles for offline reading in the format you want (HTML, PDF, EPUB, ZIP), organize them into categories or tags, and use a built-in scripting engine to customize how articles are processed. It connects to outside services through incoming and outgoing webhooks (Pocket, RSS, Keeper, Shaarli, wallabag, S3 and more), making it a simple, ad-free reading setup for homelabbers who want ownership of their article flow.

Platform availability

Available on 3 of 10 platforms

  • Unraid (not listed)
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac
  • Windows (not listed)
  • Linux
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

51/100 Fair

Maintained
77last commit 3 days ago
Popular
54476 GitHub stars
Easy to install
453 install platforms, install notes
Light to run
No data
Security check
07 serious findings, 7 minor, CI, tests, OpenSSF Scorecard 3.7/10

Based on 4 of 5 factors.

Availability: platform listings confirmed today

GitHub stars
476
Open issues
10
Last commit
2026-11-18
Latest release
v1.2.0
License
AGPL-3.0
Activity
declining

Checked yesterday - source: GitHub (ncarlier/readflow)

Resources & Compatibility

Requirements not published yet.

Checked yesterday - source: Docker Hub image tags and published docs

First-install notes

  • Download & install Download the latest build for macOS or Linux from the project's official GitHub releases page and install it like any standard desktop application. source
  • Desktop install Download the latest macOS or Linux binary from the GitHub Releases page and follow the included setup instructions. source

Fetched yesterday - each note links to its source

Alternatives (5)

  • Calibre-go
  • FreshRSS - FreshRSS is a lightweight, customizable, self-hosted Really Simple Syndication (RSS) and Atom feed aggregator for organizing and reading fe…
  • Glance - Glance is a self-hosted dashboard that aggregates RSS, subreddit posts, YouTube, and server statistics.
  • Liseur
  • ReadAnywhere

Checked yesterday - source: AlternativeTo

Common questions

How do I run Readflow with Docker and which port does it use?

The Docker example maps port 8080 from the container and sets an empty READFLOW_DATABASE_URI environment variable. The web UI is then available on localhost port 8080.

How do I configure Readflow?

Use a TOML configuration file passed with the -c parameter or via the READFLOW_CONFIG environment variable. You can generate a sample file with the init-config -f config.toml command.

How do I authenticate to the API or use readflow-ctl?

The CTL supports Basic Auth or OIDC Device Code Flow. The default Docker Compose file mounts a passwd file with a demo user and demo password.

Is there a mobile app for Readflow?

Mobile support is provided through the web UI as a Progressive Web App, giving the same experience as desktop.

Which formats can I save articles in for offline reading?

Articles can be saved in HTML, PDF, EPUB, or ZIP format.

Can Readflow connect to other services?

It uses incoming and outgoing webhooks to connect to services such as Pocket, RSS, Keeper, Shaarli, wallabag, and S3 buckets.

Answers sourced from github.com

Community

Collected yesterday - public community threads