中文文档

Koodo Reader Extension

A browser extension that extends Koodo Reader with web clipping and cloud storage support.

Features

• Clip Web Articles — Save any web article to your library for later reading with one click. Requires the Koodo Reader desktop app to be installed. Articles are saved as HTML files in your library.
• Bypass Web Limitations — Due to restrictions with WebDAV and S3-compatible storage, you may be unable to sync or import books through these data sources in the browser. Install this extension to work around those limitations on the Koodo Reader web app.

Quick Start

Development

# Install dependencies
npm install

# Chrome dev mode (with HMR)
npm run dev

# Or specify browser
npm run dev:chrome
npm run dev:firefox

Build

# Chrome production build
npm run build

# Or specify browser
npm run build:chrome
npm run build:firefox

Build output goes to dist_chrome and dist_firefox directories respectively.

Load Extension

Chrome

1. Navigate to chrome://extensions
2. Enable "Developer mode"
3. Click "Load unpacked"
4. Select the dist_chrome directory

Firefox

1. Navigate to about:debugging#/runtime/this-firefox
2. Click "Load Temporary Add-on"
3. Select any file inside the dist_firefox directory

Tech Stack

• React 19
• TypeScript
• Tailwind CSS 4
• Vite 6
• Chrome Extension Manifest V3
• webextension-polyfill (optional Firefox compatibility)

License

This library is distributed under the terms of GNU AGPL v3