Awesome Open Source
Awesome Open Source


Build Status Go Report Card Docker pulls

Read your Internet article flow in one place with complete peace of mind and freedom.



  • Read articles from anywhere in one place.
  • Save articles for offline reading or locally on you disk in the format you want (HTML, EPUB, ZIP, ...).
  • Create categories and classify new articles automatically thanks to a customizable rule engine.
  • Link with external services thanks to incoming and outgoing webhooks (RSS, Keeper, Pocket, Wallabag, S3 bucket, and more...).
  • Receive notifications when new articles are available.
  • Enjoy the same user experience on mobile as on desktop thanks to Progressive Web App support.
  • And all this without ads and trackers.


Run the following command:

$ go get -v

Or download the binary regarding your architecture:

$ curl -sf | sh
$ # or
$ curl -s | bash

Or use Docker:

$ docker run -d --name=readflow ncarlier/readflow:edge


Readflow configuration is a TOML file that you can specify using the --config command line parameter or by setting the READFLOW_CONFIG environment variable.

You can initialize a configuration file example by using the --init-config command line parameter.

A configuration file example can be found here.

Type readflow -h to display all parameters and related environment variables.


You can access Web UI on http://localhost:8080/ui



The documentation can be found here:


You can explore the server API using GraphiQL endpoint: http://localhost:8080/graphiql


To be able to build the project you will need to:

  • Install makefiles external helpers:
    $ git submodule init
    $ git submodule update

Then you can build the project using make:

$ make

Type make help to see other possibilities.


These amazing people have sponsored this project:

Code Lutin



Readflow artworks except the logo are under the Licence Creative Commons Attribution-NonCommercial-NoDerivatives 4.0. Attribution to Maxime Belloche

Avatar atrworks are under the License Creative Commons Attribution 4.0. Attribution to David Revoy

Readflow is provided under the GNU Affero General Public License Version 3 (AGPLv3).

Readflow is a personal news reader service.

Copyright (C) 2021 Nicolas Carlier

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <>

Alternatives To Readflow
Select To Compare

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Typescript (268,309
Reactjs (167,336
Golang (164,214
Graphql (16,003
Article (14,115
Webhook (8,958
Reader (8,309