Readability Addon for FreshRSS

This extension uses Readability, Mercury or the free FiveFilters implementation for fetching article content for selected feeds.

• The Readbility API is offered by phpdockerio's Docker image
• The Mercury API is offered by wangqiru's Docker image.
• The FiveFilters API is offered by heussd's Docker image.

Usage

Configure the hosts in the configuration section of the extension according to your config.

After ticking the feeds YOU HAVE TO SCROLL DOWN AND HIT SUBMIT.

In the following example the Readability host is configured according to the docker-compose.yml from this repo:

If all options are ticked, the FiveFilters parser will be used.

Setup

If you run FreshRSS from docker-compose, this is what you need to add to your config. Maybe have a look at the example docker-compose.yml file for complete reference.

  read:
    image: "phpdockerio/readability-js-server"
    restart: always

  merc:
    image: "wangqiru/mercury-parser-api"
    restart: always

  fivefilters:
    image: "heussd/fivefilters-full-text-rss:latest"
    environment:
      # Leave empty to disable admin section
      - FTR_ADMIN_PASSWORD=
    volumes:
      - "./rss-cache:/var/www/html/cache/rss"
    ports:
      - "127.0.0.1:8000:80"
    restart: always

Since both Readability and Mercury offer their API on port 3000 and are only used locally, the reduced config suffices our purpose. The FiveFilters implementation on the other hand is a full blown feed customizer with an easy to use web interface, that will also generate whole feed urls for you to add to FreshRSS itself. I'd highly recommend to make this frontend available for your usage.

Local Instance

If you run freshrss locally without docker, you can still use the docker images, but you'd have to forward the ports to you local host, so freshrss can access them:

services:
  read:
    image: phpdockerio/readability-js-server
    restart: always
    ports:
      - 127.0.0.1:3000:3000

  merc:
    image: wangqiru/mercury-parser-api
    restart: always
    ports:
      - 127.0.0.1:3001:3000

  fivefilters:
    image: "heussd/fivefilters-full-text-rss:latest"
    environment:
      # Leave empty to disable admin section
      - FTR_ADMIN_PASSWORD=
    volumes:
      - "./rss-cache:/var/www/html/cache/rss"
    ports:
      - "127.0.0.1:3002:80"
    restart: always

In that case your value for the Readability Host is http://127.0.0.1:3000; for the Mercury Host it'd be http://127.0.0.1:3001 and for the fivefilters container it's: http://127.0.0.1:3002

No Containers ...

If you don't like containers at all, I can't help you.

Notes

• I won't provide help on problems inside the used containers.