Architecture Overview

The Kobo Plugin bridges two different reading progress tracking systems: Kobo's centralized SQLite database and KOReader's distributed sidecar files.

Core Concept

graph LR
    K[Kobo Database<br/>Centralized<br/>Chapter-based] <-->|Plugin<br/>Sync| R[KOReader Sidecars<br/>Distributed<br/>Percentage-based]

    style K fill:#fff3e0
    style R fill:#e1f5ff

The plugin acts as a translator and synchronizer between these two fundamentally different systems.

Key Topics

High-Level Architecture

Visual overview of components and their relationships. Start here to understand the overall system design.

Database & Data Storage

How both systems store reading progress, why they're different, and how the plugin bridges the gap. This is the most important section for understanding the plugin's core functionality.