Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

The Old Reader Cli (Client)

The Old Reader GUI

Unofficial program

This is an unofficial perl client/gui based on the documentation found at


The following modules are used by the package:

  • JSON
  • LWP::UserAgent
  • IO::Prompt
  • Curses::UI (used for gui only, not mandatory)

On debian you can install the packages using the apt command:

If you want the gui

$ apt-get install libjson-perl libwww-perl libio-prompt-perl libcurses-ui-perl libnotify-bin

$ cpan -i Curses::UI::POE

If you don't want the gui, just install

$ apt-get install libjson-perl libwww-perl libio-prompt-perl

For OS X (using Homebrew/cpanm)

$ brew install cpanm
$ sudo perl -MCPAN -e 'install JSON,LWP::UserAgent,IO::Prompt,Curses::UI,Curses::UI::POE,Mozilla::CA'

First run and creation of configuration file

When running for the first time, the gui will ask you to create a configuration file.

$ ./
Creating configuration:
Username: my@mail
Password: ************


Run the GUI

To run the gui, run the script

$ ./

When loaded, you will find a list of labels (on the left), and a list of associated items, on the right.

The Old Reader GUI

Use tab to switch between windows, and press enter to select an item.

Press ? key at any time to display the shortcuts you can use.


A list of automatic commands can be runned using triggers.

You will need to edit the configuration file manually since there is no gui (for now) to edit them.

The syntax is simple, there is one trigger per line, and a trigger must have 2 parts:

  • Condition(s)
  • Action(s)

Available conditions:

  • title=value # Check for title containing value
  • label=value # Check for feed containing this label
  • unread=1 # Check for item not read already
  • unread=0 # Check for item read already

Available actions:

  • open # Auto open on browser
  • read # Mark item as read
  • star # Mark item as starred
  • like # Mark item as liked
  • share # Mark item as shared (without message)
  • notify # Display a desktop notification with the feed title


# Default structure is:
# trigger:"conditions","run actions"

# Auto mark as read sponsored feeds

# This trigger auto open on browser all the items displayed that have the label "Download"

# This trigger auto flag to read all the unread items

# This trigger auto open on browser all the items which title contains the word video

# This trigger send a desktop notification of each new item displayed

# You can also mix all them together:
# Auto open and read  the unread items that are on label "News", and which title contains the word video