graham.systems / paperbnd.koplugin
Unofficial Paperbnd/Popfeed plugin for KOReader
fork atom
Lua 97.2%
Nix 2.8%
10 1 1

Clone this repository

https://tangled.org/graham.systems/paperbnd.koplugin
git@tangled.org:graham.systems/paperbnd.koplugin

For self-hosted knots, clone URLs may differ based on your setup.

Download tar.gz
README.md

paperbnd.koplugin#

A KOReader plugin for syncing your reading progress to Paperbnd/Popfeed.

This plugin associates a document in KOReader with a social.popfeed.feed.listItem record in your Atproto PDS, and then enables you to update that record with your reading progress at automatically or at the press of a button.

Some limitations:

  • Books must be added to your account from the Paperbnd website or Popfeed website/app before they can be linked
  • Books must already be in a currently_reading_books list

Installation#

  1. Download/clone this repository
  2. Drag the paperbnd.koplugin folder into your KOReader plugins directory
  3. Restart KOReader

Usage#

  1. Create an App Password wherever your Atproto account is managed (Bluesky, Tangled, elsewhere)
  2. Open the KOReader menu
  3. Navigate to the second page of the first tab
  4. Select the "Paperbnd" option
  5. Select "Set credentials"
  6. Enter your Handle and App Password when prompted
  7. Select "Link current book"
  8. Select your book from the list
  9. From the Paperbnd menu, select "Sync progress now"