Skip to content

hi-upchen/kobo-up

Repository files navigation

πŸ“š Kobo Note Up - Export Kobo Highlights When Official Export Not Working

License TypeScript Next.js Live Demo

Finally export highlights from ALL your Kobo books - including sideloaded PDFs and EPUBs that official Kobo export ignores. Free browser-based tool, no installation required.

πŸš€ Try It Now - Export Your Kobo Notes | View Demo | Report Issue


🎯 The Problem: Kobo Export Not Working for Your Books?

If you're here, you've probably discovered that:

  • ❌ Kobo's official export doesn't work with sideloaded books (PDFs, EPUBs you added manually)
  • ❌ Your highlights get truncated when they're too long
  • ❌ You need complex software like Calibre just to access your own notes
  • ❌ Manual database extraction is technical and frustrating

✨ The Solution: Kobo Note Up

A free, browser-based tool that actually exports highlights from ALL your books - whether they're from the Kobo store or your personal library.

Why Kobo Note Up?

Problem Our Solution
Official export ignores sideloaded books βœ… Works with ALL books - store-bought and sideloaded
Highlights get truncated βœ… Exports complete highlights, no matter the length
Need to install Calibre or other software βœ… Runs entirely in your browser - zero installation
Manual database extraction is complex βœ… Automatic database detection with one click
Privacy concerns with online tools βœ… 100% local processing - your data never leaves your device

πŸš€ Quick Start - Export Kobo Highlights in 5 Steps

  1. Connect your Kobo e-reader to your computer via USB
  2. Open Kobo Note Up in any modern browser (Chrome, Edge, Firefox, or Safari)
  3. Select your Kobo device folder when prompted
  4. Browse your books and highlights (automatically extracted)
  5. Export to Markdown or text format

That's it! No installation, no account, no data uploaded anywhere.

✨ Key Features

  • πŸ“– Export from ALL Books - Works with sideloaded PDFs, EPUBs, and store-bought books
  • πŸ”’ 100% Private - All processing happens locally in your browser
  • ⚑ Instant Export - No installation, no setup, just works
  • πŸ“ Multiple Formats - Export to Markdown (for Obsidian/Notion) or plain text
  • 🎯 Smart Detection - Automatically finds your Kobo database
  • πŸ’» Cross-Platform - Works on Windows, Mac, and Linux
  • πŸ†“ Completely Free - Open source with MIT license

πŸ–₯️ Browser Compatibility

Browser Support How?
Chrome βœ… Full Support Select Kobo root folder directly
Edge βœ… Full Support Select Kobo root folder directly
Firefox βœ… Full Support Select .kobo folder on device
Safari βœ… Full Support Select .kobo folder on device
Opera βœ… Full Support Select Kobo root folder directly

πŸ“‹ How to Find Your Kobo Database

When you connect your Kobo and open our tool, it automatically searches for your KoboReader.sqlite file. This file contains all your highlights and notes.

Typical location after connecting Kobo via USB:

  • Windows: E:\.kobo\KoboReader.sqlite (drive letter may vary)
  • Mac: /Volumes/KOBOeReader/.kobo/KoboReader.sqlite
  • Linux: /media/[username]/KOBOeReader/.kobo/KoboReader.sqlite

πŸ› οΈ For Developers

Tech Stack

  • Frontend: Next.js 14.2+ with TypeScript
  • Database: SQL.js (WebAssembly SQLite in browser)
  • Styling: Tailwind CSS
  • Privacy: 100% client-side processing

Installation

# Clone the repository
git clone https://github.com/upchen/kobo-up.git
cd kobo-up

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

Project Structure

src/
β”œβ”€β”€ app/                # Next.js App Router
β”œβ”€β”€ components/         # Reusable UI components
β”œβ”€β”€ services/          # Business logic (export, database)
β”œβ”€β”€ models/            # Database operations
└── utils/             # Helper functions

🀝 Contributing

We welcome contributions! Here are ways to help:

  • πŸ› Report bugs
  • πŸ’‘ Suggest features
  • πŸ”§ Submit pull requests
  • ⭐ Star the repository
  • πŸ“’ Share with other Kobo users

Ideas for Contribution

  • Add JSON export format
  • Support for more e-reader brands
  • Batch export improvements
  • UI/UX enhancements
  • Translation to other languages

πŸ“– FAQ

Why doesn't Kobo's official export work with my sideloaded books?

Kobo's built-in export only works with books purchased from their store. Sideloaded content (PDFs, EPUBs you added manually) is ignored. Kobo Note Up solves this by reading directly from your Kobo's database.

Is it safe to use? Will it damage my Kobo?

Absolutely safe! We only READ your database, never write to it. Your Kobo device remains untouched. All processing happens in your browser.

How do I use this with Firefox or Safari?

Firefox and Safari are fully supported! When prompted, select the .kobo folder inside your Kobo device (press ⌘+Shift+. on Mac or Ctrl+H on Windows to show hidden folders). Chrome and Edge can select the root folder directly.

Can I export highlights from specific books only?

Yes! You can browse your library and export individual books or export your entire library at once.

What formats can I export to?

Currently Markdown (.md) and plain text (.txt). Markdown works great with note-taking apps like Obsidian and Notion.

Do you store my highlights or personal data?

No! Everything happens locally in your browser. We cannot see your highlights, books, or any personal information. Your privacy is guaranteed.

πŸ™ Acknowledgments

Special thanks to:

πŸ“„ License

MIT License - feel free to use this tool however you like!

πŸ’– Support

If Kobo Note Up helped you export your highlights:

  • ⭐ Star this repository to help others find it
  • β˜• Buy me a coffee if you'd like to support development
  • πŸ“’ Share with other Kobo users facing export issues

Made with ❀️ by Up Chen
Try Kobo Note Up Now β†’

About

A website reads Kobo database (sqlite) and shows the book and notes.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages