# Kobo Device Setup Guide

There are two ways to use a Kobo with Bookhoard, and they can be chosen
independently per device:

| Way | Status | What you get |
| --- | --- | --- |
| **KOReader on the Kobo** | Works today, fully | Reading position, bookmarks, highlights, notes, OPDS wireless book delivery |
| **Stock Kobo firmware (native sync)** | Server support is complete; device-side enablement is the remaining piece | Reading position and stats, bookmarks/highlights/notes, shelf mappings (your collections as Kobo shelves), automatic EPUB → KEPUB conversion, and the Kobo's own sync experience |

## Using a Kobo today

**KOReader runs on Kobo hardware** and syncs fully with Bookhoard right
now — the [KOReader Setup Guide](koreader-setup.md) walks the whole path
(plugin install, server approval, OPDS delivery, troubleshooting).

## About native Kobo sync

The server side of the native protocol is implemented and documented: the
Kobo sync and initialization endpoints, bookmark and markup (highlight and
note) sync, shelf mappings that expose your collections as Kobo shelves,
and the KEPUB sidecar configuration used for conversion. What remains is
the device-side rollout, so stock-firmware sync is not yet something to
rely on for daily use — this guide will gain a full setup walkthrough when
that lands.

Nothing about native sync takes anything away from KOReader: the two can
coexist, and a KOReader setup keeps working either way.

## FAQ

**Q: Should I buy a Kobo to use with Bookhoard today?**
A: Yes, via KOReader — it is the supported path today and covers sync plus
wireless book delivery.

**Q: Will I have to redo anything when native sync lands?**
A: No — KOReader keeps working; native sync just adds the stock-firmware
option.

## Additional Resources

- [KOReader Setup Guide](koreader-setup.md) — works on Kobo today
- [Bookhoard Universal Sync Guide](../sync-guide.md)
- Kobo sync protocol (for developers): [Kobo API docs](../../developer/api/kobo/sync_from_server.md)

---

**Last Updated**: August 2026
**Bookhoard Version**: 1.0