# 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"

[Paperbnd]: https://paperbnd.club/
[Popfeed]: https://popfeed.social/
[KOReader]: https://koreader.rocks/