Libra Colour Kobo Annotations Exporter - Export Your Highlights & Notes to Markdown

[apheleia]

Hey everyone! 👋

I've been frustrated with the lack of good options for exporting Kobo annotations in my obsidian, so I created a Python script that automatically extracts all your highlights and notes from your Kobo eReader and exports them to a basic formatted Markdown files - one file per book.

✨ What it does:
Automatically detects your Kobo database (works on macOS but not tested on Linux and Windows)
Extracts all highlights and annotations from your library
Exports each book's annotations to a separate Markdown file
Preserves chapter/location information
Creates automatic backups of existing files
Shows detailed statistics about your reading habits

🔧 Features:
Zero configuration needed - just plug in your Kobo and run
Handles file naming conflicts intelligently
Debug mode for troubleshooting
Verbose output option for detailed info
Clean, readable Markdown output format

📝 Sample Output:

# Annotations - Book Title

*Exported on 09/06/2025 at 14:30*

> [!quote] Chapter 1
> This is your highlighted text
> 
> > [!note]
> > Your personal annotation here

🛠️ Usage:

python3 export_kobo_annotations.py

Or

python3 export_kobo_annotations.py --output ~/MyAnnotations --verbose

The script is open source and available on GitHub. It's written in Python 3 with no external dependencies - just uses the standard library.

GitHub