Skip to content

feat(koreader): add KOReader sync API for reading progress synchroniz…#6

Merged
AshDevFr merged 1 commit intomainfrom
koreader
Mar 14, 2026
Merged

feat(koreader): add KOReader sync API for reading progress synchroniz…#6
AshDevFr merged 1 commit intomainfrom
koreader

Conversation

@AshDevFr
Copy link
Owner

…ation

Implement the KOReader sync protocol, allowing KOReader devices to sync reading progress with Codex. This includes authentication endpoints, progress get/put handlers, and document matching via KOReader's partial MD5 hash.

Key changes:

  • Add KOReader API routes under /koreader/ with auth and sync endpoints
  • Add koreader_hash column to books table via migration
  • Compute KOReader-compatible partial MD5 hashes during library scanning
  • Add KoreaderApi config section (enabled/disabled toggle)
  • Extend BookRepository with find_by_koreader_hash query
  • Parse KOReader EPUB progress formats (DocFragment XPath and doc_fragment variants) into page numbers
  • Add integration and unit tests

…ation

Implement the KOReader sync protocol, allowing KOReader devices to
sync reading progress with Codex. This includes authentication
endpoints, progress get/put handlers, and document matching via
KOReader's partial MD5 hash.

Key changes:
- Add KOReader API routes under /koreader/ with auth and sync endpoints
- Add koreader_hash column to books table via migration
- Compute KOReader-compatible partial MD5 hashes during library scanning
- Add KoreaderApi config section (enabled/disabled toggle)
- Extend BookRepository with find_by_koreader_hash query
- Parse KOReader EPUB progress formats (DocFragment XPath and
  _doc_fragment_ variants) into page numbers
- Add integration and unit tests
@cloudflare-workers-and-pages
Copy link

Deploying codex with  Cloudflare Pages  Cloudflare Pages

Latest commit: a66c702
Status: ✅  Deploy successful!
Preview URL: https://ad912073.codex-asm.pages.dev
Branch Preview URL: https://koreader.codex-asm.pages.dev

View logs

@AshDevFr AshDevFr merged commit 2b4440d into main Mar 14, 2026
17 checks passed
@AshDevFr AshDevFr deleted the koreader branch March 14, 2026 22:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant