Skip to content
Boeks

Appearance

Theme

When something doesn't sync

What to check when reading, highlights, or books don't come through, and where to find out what happened.

Published

Most sync problems come down to a folder that isn't syncing everything, or devices that can't see each other. Here's what to check, roughly in order.

See what happened

  • On your Mac and iPhone, Devices lists each device with when it was last active and last synced.
  • On your Mac, a device's page has Show Log, with what it did at each sync and why it skipped anything.
  • On your Kobo, Boeks's logo in the status bar shows what the last sync over Wi-Fi or USB brought in, book by book, when you tap it. Boeks in the reader's menu shows the book's timeline across your devices.

Your library folder

Your devices share reading through small files in your library's hidden .boeks folders.

  • Hidden folders are skipped. Some sync services and tools leave out files whose names start with a dot, Nextcloud among them, unless you tell them not to. Make sure yours syncs the .boeks folders.
  • Books aren't downloaded. iCloud Drive can keep books only in the cloud to save space on your iPhone. Your iPhone sends a book to your Kobo once it's downloaded there.
  • The service hasn't caught up. A change shows on your other devices once your sync service has copied it, which can take a moment, or longer on a slow connection.
  • Conflicted copies that some services make, like name (conflicted copy).jsonl, are rare with Boeks: each device writes only its own files. If you see one, tell us.

Over Wi-Fi

  • Keep Boeks open. Your Mac answers while Boeks is open there; your iPhone and iPad only while Boeks is on screen.
  • Use the same network. Some networks, such as guest Wi-Fi in hotels or offices, keep devices from seeing each other. Your iPhone's Personal Hotspot works instead: join it from your Kobo.
  • Allow the local network. Boeks asks the first time. If you said no, turn it on in your iPhone's Settings › Privacy & Security › Local Network, or in your Mac's Privacy & Security settings.
  • Pair your Kobo once. A Kobo syncs over Wi-Fi after it has been connected to your Mac with Boeks once. See Install Boeks on a Kobo.

Your Kobo

  • After a firmware update, Boeks may be gone from your Kobo. Connect it to your Mac and install it again; your reading is kept in your library.
  • On firmware 5, Boeks for Kobo doesn't work yet. It needs firmware 4.
  • A book doesn't show on the Kobo. If Boeks couldn't convert it, the Kobo says so, with the reason. Books with DRM aren't sent.
  • Pages don't turn from your iPhone or Apple Watch: turn on Bluetooth on the Kobo and keep it awake with a book open. Page turning works on the Kobos with Bluetooth that Boeks supports.

If it still doesn't work

Email support@boeks.app. On your Mac, a device's log (Show Log) helps us see what happened.