Sync a Kobo or Kindle with Diavazo: books, progress and highlights
If you read on a Kobo or a Kindle, your books and the lines you highlighted are already on the device. Diavazo reads them from your computer's browser, puts the books in your library and turns the highlights into private quotes. After the first time, you plug in and press one button.
First: you need a computer
Syncing only works on the website, getdiavazo.com/app, open in a computer's browser. The reason is practical: the e-reader connects over its USB cable and the browser has to be able to read its files. In the phone app the page is there, but it only tells you to move to a computer.
You'll find it under Profile, Settings, Library, Kobo & Kindle. Any browser works, but Chrome and Edge make it easier, as you'll see below.
The first sync
- Connect the Kobo or Kindle to the computer with its USB cable. On a Kobo, tap Connect when it asks: until you do, the computer can't see its files.
- In Chrome or Edge, press Connect e-reader and pick the device's drive, the one called KOBOeReader or Kindle. The browser asks for permission to read it: allow it. Diavazo remembers the drive.
- In Safari, Firefox or another browser, press Pick the file by hand and pick the file straight from the device: .kobo/KoboReader.sqlite on a Kobo, documents/My Clippings.txt on a Kindle.
Diavazo reads the file, tells you how many books and highlights it found, and sends them to the server, which finds each book in the catalogue and adds it to your library. You see the progress in two steps, Finding the books in the catalogue and then Adding the books to your library, with an estimate of the time left. You can leave the page: the work goes on, and a bar at the bottom of every page shows how far along it is.
Every time after
In Chrome or Edge, once you've picked the drive, the page shows your e-reader under Your e-reader, with the line Remembered: plug it in and press Sync. Plug the device in, press Sync, and the browser asks for permission again: that's a browser rule, a web page can't skip it. To use a different e-reader, tap Change.
Each sync brings only what changed. Highlights carry an id that comes from the device, so syncing twice creates no duplicates.
The file never leaves your computer
The Kobo's database and the Kindle's clippings file are read inside the browser, on your computer. What reaches Diavazo is only a list: the books' titles and authors, progress, the text of your highlights and notes, and the device's name, used to tell you where an import came from. For a Kindle it also includes each book's ASIN, read from its file name.
That list stays on the server only until the import has finished, so it can pick up again by itself if the server restarts halfway; then it is deleted. The details are in the privacy policy.
What it reads from a Kobo
From a Kobo, Diavazo reads KoboReader.sqlite, in the hidden .kobo folder. That's where the Kobo keeps, for each book, the percentage read, its status (not started, reading, finished), the last time you opened it, the time spent reading it and, for books bought in the store, the ISBN. Next to them are your highlights, with any note you wrote in the margin.
- A book finished on the Kobo becomes Read, dated on its last reading.
- A book in progress becomes Reading, at the percentage you reached.
- Books never opened stay out, because a Kobo library is often full of free samples. If you want them, turn on Also bring in Kobo books I haven't started before syncing: they come in as Want to read. A book with highlights always comes in.
From the second sync on, the pages you read between one sync and the next, and the reading time the Kobo recorded, become reading sessions in your statistics.
What it reads from a Kindle
A Kindle doesn't keep its progress in a file anyone can read. What it does have is My Clippings.txt, in the documents folder: a list of clippings with the title, author, page or location, date and text of every highlight and note. Diavazo reads it in the languages a Kindle most often writes it in, including English, Italian, Spanish, French, German and Portuguese. Only books with at least one highlight come in; bookmarks are ignored.
Since the file doesn't say what you finished, Diavazo makes a guess: a book with highlights in the last two months becomes Reading, one whose highlights are older becomes Read, dated on the latest. The report reminds you of this, and you can fix any book from its page.
Notes you wrote are attached to the highlight you wrote them on. A note with no highlight under it is skipped, and the report tells you how many. It also tells you how many highlights couldn't be read because they went past the clipping limit the publisher sets, and how many clippings were in a language the app can't read.
The ASIN from file names
Books bought from Amazon are stored on the Kindle under a name that contains their ASIN, for example The Hobbit_B007978NPG. When you connected the whole drive in Chrome or Edge, Diavazo also reads the file names in the documents folder and gives each clippings book its ASIN. With that code the book is found sooner and more reliably. Picking just the file by hand skips this step, but the sync still works.
Highlights become private quotes
Every highlight joins your quotes as private: only you see it. If you like one enough to show it, you can make it public from your quotes. Since the device doesn't say where in the book it was, Diavazo treats it as if it came at the very end: an imported quote you make public can't spoil anything for someone who is still behind. How visibility and position work is in Quotes.
What is never touched
A sync respects what you did in Diavazo:
- progress only moves forward. If you're further along in Diavazo than the device says, yours stays;
- a book you already marked as Read or Didn't finish stays as it is;
- a book on Want to read or On hold on which the Kobo records new pages goes back to Reading;
- the first sync logs no reading sessions: nobody knows when those pages were read, and making it up would skew your pace. For how Diavazo works out your pace, read Progress and pace;
- nothing goes to the feed: your followers don't see a sync as a shower of finished books.
Books that aren't found
At the end the report shows how many books were added, updated and up to date, how many new highlights were saved and how many sessions were added. If some books weren't found, they appear in a list with the number of highlights waiting with each.
The choices are the same as for a Goodreads import: I'll add it, Hand to Diavazo or Don't add the selected, plus an automatic retry the next day for the books left over. They're explained in Importing your library. There's one extra thing for e-readers: when you add a book from the report, with I'll add it, it goes in at once with its highlights. If a title says its highlights weren't saved, add the book manually and sync the device again: Diavazo matches them to the books you added yourself.
If you choose not to add a book that has highlights, the app tells you before you confirm: those highlights won't be saved.