koodo-reader is a free, open source publishing project written in JavaScript and released under AGPL-3.0. It has 28,217 GitHub stars, 2,116 forks and 271 open issues, and was last pushed 25 hours ago. On this registry it ranks #3 of 46 tracked projects in Publishing, with 5 head-to-head comparisons available. It gained 18 stars over the last 3 tracked days.

What is koodo-reader?

What it is

Koodo Reader is a cross-platform ebook manager and reader written in JavaScript and released under the AGPL-3.0 license. It runs on Windows, macOS, Linux, Android, iOS, and the web, and it is distributed both as downloadable desktop and mobile applications and as a hosted web version at web.koodoreader.com. The project lives in the JavaScript ecosystem, is developed with yarn and git, and has been maintained for roughly seven years, with a repository that carries about 28,000 stars and 2,100 forks.

The concrete problem it solves is fragmentation in personal ebook libraries. Readers typically handle one or two formats, keep progress and annotations locked inside a single device, and offer no portable way to move a library between machines or services. Koodo Reader reads EPUB, PDF, DRM-free Mobipocket and Kindle files, plain text, FictionBook, comic book archives, Markdown, DOCX, and HTML-family documents in one interface, then syncs that library, reading progress, notes, and highlights through OneDrive, Google Drive, Dropbox, iCloud, MEGA, pCloud, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, or object storage. It also syncs reading progress with KOReader and pushes notes and highlights to Readwise, Notion, Obsidian, and Joplin.

Key capabilities

  • Reads EPUB, PDF, DRM-free MOBI, AZW3, AZW, TXT, FB2, CBR, CBZ, CBT, CB7, MD, DOCX, HTML, XML, XHTML, MHTML, and HTM files.
  • Syncs and backs up library data across OneDrive, Google Drive, Dropbox, iCloud, MEGA, pCloud, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, and object storage.
  • Supports custom AI models for AI Translation, AI Dictionary, AI Summarization, and AI Encyclopedia.
  • Ships more than 50 built-in plugins for translation, dictionaries, and text-to-speech, with support for custom plugins.
  • Includes Paddle and Tesseract OCR engines, plus local MDX dictionary lookup.
  • Exports all books in one click, and exports notes and highlights to CSV, Markdown, HTML, TXT, and PDF.
  • Serves the library as an OPDS feed and includes a browser extension for saving web content into the library.

Who uses it and how

  • Readers who keep libraries across several devices use the sync backends to carry books, progress, and annotations between desktop, mobile, and web.
  • Students and researchers import documents from cloud drives or FTP, SFTP, WebDAV, SMB, and object storage, then annotate with bookmarks, notes, and highlights.
  • Language learners use the built-in and custom plugins for translation, dictionaries, and text-to-speech, and sync vocabulary to Anki and Eudic.
  • Privacy-conscious users rely on the privacy-first design, which uses no tracking services and does not proactively upload reading data, and can lock the library with a password, PIN, Windows Hello, or Touch ID.
  • Self-hosters deploy the Docker image and share the library as an OPDS feed, with library snapshots and version control available for recovery.

Getting started

Install through the official downloads for desktop, Android, and iOS, use the hosted web version, or install via Scoop, Winget,

project readme (upstream, from github) — read inline

简体中文 | हिंदी |Português | Indonesian | English | Türkçe

Koodo Reader

A cross-platform ebook reader

Download | Preview | Roadmap | Document | Plugins

Preview







Features

  • Format support:
    • EPUB (.epub)
    • PDF (.pdf)
    • DRM-free Mobipocket (.mobi) and Kindle (.azw3, .azw)
    • Plain-text (.txt)
    • FictionBook (.fb2)
    • Comic book archive (.cbr, .cbz, .cbt, .cb7)
    • Rich text (.md, .docx)
    • HyperText (.html, .xml, .xhtml, .mhtml, .htm)
  • Platform support: Windows, macOS, Linux, Android, iOS and Web
  • Sync and backup your data with OneDrive, Google Drive, Dropbox, iCloud, MEGA, pCloud, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, or Object Storage
  • Easily import books from OneDrive, Google Drive, MEGA, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, or Object Storage
  • Use your custom AI model to power AI Translation, AI Dictionary, AI Summarization, and AI Encyclopedia
  • Sync reading progress with KOReader
  • Sync notes and highlights to Readwise, Notion, Obsidian, Joplin, and more
  • Support local MDX dictionary lookup
  • Automatically sync words to Anki and Eudic
  • Protect your library with password, PIN, Windows Hello, Touch ID, and more
  • One-click export of all books
  • One-click export of notes and highlights, supporting CSV, Markdown, HTML, TXT, and PDF
  • Privacy-first design: no tracking services, and no proactive uploading of your reading data or personal information
  • Support OPDS protocol and share your library as an OPDS feed
  • Support browser extension to save anything on the web to your library
  • Built-in 50+ plugins for translation, dictionaries, and text-to-speech, with support for custom plugins
  • Support vertical layout book
  • Support reading statistics
  • Built-in Paddle and Tesseract OCR engines
  • Support library snapshots and version control
  • Single-column, two-column or continuous scrolling layouts
  • Text-to-speech, translation, dictionary, touch screen support, and batch import
  • Add bookmarks, notes, and highlights to your books
  • Adjust font size, font family, line-spacing, paragraph spacing, background color, text color, margins, and brightness
  • Night mode and theme color
  • Text highlighting, underline, boldness, italics, and shadow

Installation

Desktop version: Download

Web version:Visit

Android version:Download

iOS version:Download

Browser extension:Download

Install with Scoop:

scoop bucket add extras
scoop install extras/koodo-reader

Install with Winget:

winget install AppByTroye.KoodoReader

Install with Flathub:

flatpak install flathub io.github.troyeguo.koodo-reader

Install with Snap Store:

sudo snap install koodo-reader

Install with Homebrew:

brew install --cask koodo-reader

Install with Docker:

Installation Guide

Screenshot

Book list



Book display



List mode



Cover mode



Reader menu



Dark mode


Develop

Make sure that you have installed yarn and git

  1. Download the repo

    git clone https://github.com/koodo-reader/koodo-reader.git
    
  2. Enter desktop mode

    yarn
    yarn dev
    
  3. Enter web mode

    yarn
    yarn start
    

Translation

Edit current language

  1. Select your target language from the following list.

  2. Click the view button to examine the source file. The untranslated terms are listed at the bottom of each file.

  3. Translate the terms to your target language based on the given English reference

  4. Submit the translation file or just translation snippets based on the amount of your translation to this link. Pull request is also welcomed.

Language(A-Z) Code View
Amharic am View
Arabic ar View
Armenian hy View
Bengali bn View
Bulgarian bg View
Chinese (CN) zh-CN View
Chinese (MO) zh-MO View
Chinese (TW) zh-TW View
Czech cs View
Danish da View
Dutch nl View
English en View
Finnish fi View
French fr View
German de View
Greek el View
Hindi hi View
Hungarian hu View
Indonesian id View
Interlingue ie View
Irish ga View
Italian it View
Japanese ja View
Korean ko View
Persian fa View
Polish pl View
Portuguese pt View
Portuguese (BR) pt-BR View
Romanian ro View
Russian ru View
Slovenian sl View
Spanish es View
Swedish sv View
Tamil ta View
Thai th View
Tagalog tl View
Tibetan bo View
Turkish tr View
Ukrainian uk View
Vietnamese vi View

Add new language

  1. If you can't find your target language from the above list, download the English source file from this link.

  2. When you're finished translating, submit the source file to [this link](https://github.com/koodo-reader/koodo-reader/issues/new?assignees

readme truncated — read the full docs on github

Frequently asked questions

Is koodo-reader free to use?

koodo-reader is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does koodo-reader do?

A modern ebook manager and reader with sync and backup capacities for Windows, macOS, Linux, Android, iOS and Web

What is koodo-reader written in?

koodo-reader is primarily written in JavaScript. Its source is publicly available at https://github.com/koodo-reader/koodo-reader, and it has 28,217 GitHub stars.