Export Notes from Kobo eReaders
IMPORTANT: the project moved to GitHub, this page remains online for historical purposes only!
In this page I describe a Python script to export notes and highlights from Kobo eReaders. The script comes in Python 2.x and Python 3.x version, and it works under Linux, Mac OS X and Windows.
With the current version (v. 1.0.3, 2015-01-23) of
export_Kobo_notes.py, you can:
- export all your annotations and highlights from your Kobo eReader
- export the annotations and highlights of a book only
- export formats include CSV and human-readable strings
Python, either version 2.x or 3.x, installed on your
system to run
First, copy the file
KoboReader.sqlite from your Kobo device
in the same directory where you downloaded the export script. You can find
KoboReader.sqlite in the hidden
.kobo/ directory of the USB
volume that pops up when you connect your Kobo to your PC via the USB
Then, open a terminal, go to the directory mentioned above, and issue the command:
to get the list of available options:
- If you use Python 3.x, replace
- You must have the Python executable (or a directory containing it) listed
PATHenvironment variable, or you need to supply its full path.
- Bear in mind that no official specifications are published by Kobo, hence
the script works as far as my understanding of the database structure of
KoboReader.sqliteis opened in read-only mode, it is advisable to make a copy of it on your PC and export your notes from this copy, instead of accessing the file on your Kobo eReader device.
Support and Contribution
The current version runs both under Python 2 or Python 3, and it has been
tested under Linux (Debian, Fedora) and Windows (XP, 7). Unfortunately, since
I do not have any financial support for the project, I cannot offer support
for all the possibile values of the tuple (OS, Python version, console
encoding). Therefore, only problems running
a Linux environment will receive full priority.
If you want to contribute some code or you have suggestions, please let me know by sending an email containing the string "export_Kobo_notes" in the subject. Thanks!
Pierre-Arnaud Rabier suggested adding the
-t switches to extract the annotations and highlights for a