koodo-reader

    koodo-reader/koodo-reader

    #23 this week

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

    frontend
    documentation
    book
    cb7
    cbr
    cbt
    cbz
    JavaScript
    AGPL-3.0
    27.4K stars
    2.0K forks
    27.4K GitHub watchers
    Updated 7/8/2026
    View on GitHub

    Backblaze Generative Media Hackathon

    Build the next generation of AI media apps with Genblaze, stored on Backblaze B2. $10,000 in prizes.

    Enter the hackathon

    Loading star history...

    Use Cases & Benefits

    • A cross-platform ebook manager and reader supporting multiple formats with sync and backup across desktop, mobile, and web platforms.
    • Offers extensive cloud storage integration and AI-powered features like translation, dictionary, and summarization for enhanced reading experience.
    • Use for managing and reading diverse ebook and comic formats on Windows, macOS, Linux, Android, iOS, and web browsers.
    • Use for syncing and backing up ebook libraries seamlessly across multiple devices using popular cloud services and protocols.
    • Use for enhancing reading accessibility with text-to-speech, customizable layouts, and AI-assisted translation and note-taking.

    About koodo-reader

    Koodo Reader

    A cross-platform ebook reader

    Preview







    Feature

    • 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)
      • Hyper Text (.html, .xml, .xhtml, .mhtml, .htm)
    • Platform support: Windows, macOS, Linux, Android, iOS and Web
    • Utilize OneDrive, Google Drive, Dropbox, MEGA, pCloud, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, Object Storage to sync and backup your data.
    • Easily import books from OneDrive, Google Drive, MEGA, Yandex Disk, Box, FTP, SFTP, WebDAV, SMB, Object Storage
    • AI Translation, AI Dictionary, AI Summarization
    • Single-column, two-column, or continuous scrolling layouts
    • Text-to-speech, translation, dictionary, touch screen support, batch import
    • Add bookmarks, notes, 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 highlight, underline, boldness, italics and shadow

    Installation

    Desktop Version: Download

    Web Version:Visit

    Android Version:Download

    iOS Version:Download

    Install with Scoop:

    scoop bucket add extras
    scoop install extras/koodo-reader
    

    Install with Homebrew:

    brew install --cask koodo-reader
    

    Install with Docker:

    [!NOTE] The Docker version stores data in the browser cache by default. For your data security, please deploy and access it via HTTPS, then save the data to your local folder. Alternatively, you can enable the data source feature to synchronize the data to a specified server path.

    If you only need to deploy the web version, simply use the command below.

    docker run -d \
      --name koodo-reader \
      -p 80:80 \
      -p 8080:8080 \
      -e ENABLE_HTTP_SERVER=false \
      -e SERVER_USERNAME=admin \
      -e SERVER_PASSWORD=securePass123 \
      -v /path/to/host/uploads:/app/uploads \
      ghcr.io/koodo-reader/koodo-reader:master
    

    If you also want to enable the data source feature, please:

    1. Set ENABLE_HTTP_SERVER to true
    2. Change SERVER_USERNAME and SERVER_PASSWORD to a secure username and password
    3. Replace /path/to/host/uploads with the folder where you want to store reading data

    Then, select Docker as the data source in Koodo Reader.

    Data source functionality use port 8080, and web version use port 80 by default. If you want to switch to port 8090, just change -p 8080:8080 to -p 8090:8080.

    If you want to use Docker Secrets to set SERVER_PASSWORD, please refer to docker-compose-secret.yml

    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. Sumbit 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)CodeView
    AmharicamView
    ArabicarView
    ArmenianhyView
    BengalibnView
    BulgarianbgView
    Chinese (CN)zh-CNView
    Chinese (MO)zh-MOView
    Chinese (TW)zh-TWView
    CzechcsView
    DanishdaView
    DutchnlView
    EnglishenView
    EsperantoeoView
    FinnishfiView
    FrenchfrView
    GermandeView
    GreekelView
    HindihiView
    HungarianhuView
    IndonesianidView
    InterlingueieView
    IrishgaView
    ItalianitView
    JapanesejaView
    KoreankoView
    PersianfaView
    PolishplView
    PortugueseptView
    Portuguese (BR)pt-BRView
    RomanianroView
    RussianruView
    SlovenianslView
    SpanishesView
    SwedishsvView
    TamiltaView
    ThaithView
    TagalogtlView
    TibetanboView
    TurkishtrView
    UkrainianukView
    VietnameseviView

    Add new language

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

    2. When you finish translation, submit the source file to this link. Pull request is also welcomed.

    Discover Repositories

    Search across tracked repositories by name or description