A clean & simple, self-hosted RSS reader
PHP JavaScript CSS
Switch branches/tags
Clone or download



Readr is a clean & simple, self-hosted RSS reader.

It is currently under active development, please report any issues you have.

Readr aims to be as simple as possible to set up and use with no external dependencies and no configuration file to customize.

Licensed under the GPLv3 license.



  • PHP 5.3.7+ with sqlite enabled
  • mod_rewrite Apache module enabled


  1. Upload all files to your server. Don't forget the .htaccess file.
  2. Make the directory /data writeable
  3. Create a cronjob to update your feeds automatically via curl or wget and point it to http://yourdomain/update


  • space : next entry
  • shift + space : previous entry
  • r or m : mark as read/unread
  • f or s : toggle favorite
  • v : open the original source in a new window


Readr makes use of the following libraries:


Pablo Prieto, pabloprieto.net


  • v0.9
    • New search box
    • New option to auto delete oldest entries
  • v0.8
    • New autocomplete UI for tags
    • Export subscriptions as OPML file
  • v0.7
    • 'Emulate HTTP' option added for compatibility with servers that don't support default REST/HTTP approach
    • Remember expanded/collapsed state in the feeds menu
  • v0.6
    • Responsive design
    • Direct urls to feeds, tags and entries
    • Added keyboards shortcuts
  • v0.5.1
    • Security fix
  • v0.5
    • Initial version