john-okeefe
26f1f98736
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
43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# 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](koreader-setup.md)** 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
|
|
|
|
- [KOReader Setup Guide](koreader-setup.md) — works on Kobo today
|
|
- [Bookhoard Universal Sync Guide](../sync-guide.md)
|
|
- [Bookhoard API Reference](../../developer/api-reference.md)
|
|
|
|
---
|
|
|
|
**Last Updated**: August 2026
|
|
**Bookhoard Version**: 1.0
|