greader

greader

RSS service, providing api similar to google reader.

Start Server

By Docker

• Run

docker run -d \
  -e MYSQL_HOST=xx \
  -e MYSQL_USERNAME=xx \
  -e MYSQL_PASSWORD=xx \
  -e MYSQL_DATABASE=xx \
  -p 8081:8081 \
  ghcr.io/chyroc/greader:latest

By Docker Compose

• Create docker-compose.yml

curl -fsSL https://raw.githubusercontent.com/chyroc/greader/master/docker-compose.yml > docker-compose.yml
``

• Run

docker-compose up -d

By Binary

• Install Binary

go install github.com/chyroc/greader@latest

• Run

MYSQL_HOST=xx \
  MYSQL_USERNAME=xx \
  MYSQL_PASSWORD=xx \
  MYSQL_DATABASE=xx \
  greader start

Register User

By Docker

• Run

docker run -d \
  -e MYSQL_HOST=xx \
  -e MYSQL_USERNAME=xx \
  -e MYSQL_PASSWORD=xx \
  -e MYSQL_DATABASE=xx \
  -p 8081:8081 \
  ghcr.io/chyroc/greader:latest \
  greader register -username <username> -password <password>

By Binary

• Install Binary

go install github.com/chyroc/greader@latest

• Run

MYSQL_HOST=xx \
  MYSQL_USERNAME=xx \
  MYSQL_PASSWORD=xx \
  MYSQL_DATABASE=xx \
  greader register -username <username> -password <password>

RSS API

<your host>/api/greader

TODO

• Newsletter Address
• filter && action
• import && export opml file

Ref

• https://ranchero.com/downloads/GoogleReaderAPI-2009.pdf
• https://github.com/Ranchero-Software/NetNewsWire/blob/mac-6.1.1b1/Account/Sources/Account/ReaderAPI/ReaderAPICaller.swift
• https://github.com/FreshRSS/FreshRSS/blob/1.20.2/p/api/greader.php