Files
bookhoard/docs/user/devices/kobo-setup.md
T
john-okeefe 26f1f98736 docs(kobo): mark native Kobo sync as coming soon
Native Kobo sync is implemented server-side but not yet supported on
real devices, so stop documenting it as a working feature.

- Rewrite kobo-setup.md as a coming-soon stub: point users to KOReader
  (which runs on Kobo hardware) as the supported path today, and list
  what native sync will deliver when released
- Add 'Coming Soon' status banners to the Kobo protocol spec, all five
  Kobo endpoint docs, and both API references, noting the endpoints are
  under active development and may change
- Tag the device shelf endpoints as pending native Kobo support
2026-08-20 14:14:43 -04:00

1.7 KiB

Kobo Device Setup Guide

🚧 Coming Soon

Native Kobo sync is not available yet. It is actively being developed and this guide will be filled in as the feature lands.

Using a Kobo With Bookhoard Today

You don't have to wait: KOReader runs on Kobo hardware and syncs fully with Bookhoard today — reading position, bookmarks, highlights, and notes, plus OPDS wireless book delivery.

See the KOReader Setup Guide for complete instructions.

What's Planned for Native Kobo Sync

When released, native Kobo sync will let stock Kobo firmware talk directly to Bookhoard:

  • Reading position sync — percentages, pages, and reading statistics
  • Bookmarks, highlights, and notes — synced with the web and other devices
  • OPDS wireless delivery — browse and download books directly on the Kobo
  • Automatic EPUB → KEPUB conversion — for better Kobo rendering
  • Shelf mappings — Bookhoard collections appearing as Kobo shelves

The server-side protocol endpoints are already implemented and under test; the feature will be announced when it's ready for real devices.

FAQ

Q: Should I buy a Kobo to use with Bookhoard today? A: Kobo devices work great with Bookhoard via KOReader. Native (stock firmware) sync is coming soon.

Q: What happens to my KOReader setup when native sync arrives? A: Nothing — KOReader will keep working. Native sync simply adds another option for people who prefer stock Kobo firmware.

Additional Resources


Last Updated: August 2026 Bookhoard Version: 1.0