koodo-reader

    koodo-reader/koodo-reader

    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
    comic
    docx
    ebook
    epub
    fb2
    html
    markdown
    mobi
    pdf
    reader
    rtf
    txt
    xml
    JavaScript
    AGPL-3.0
    25.7K stars
    1.9K forks
    25.7K watching
    Updated 3/14/2026
    View on GitHub
    Backblaze Advertisement

    Loading star history...

    Health Score

    75

    Weekly Growth

    +0

    +0.0% this week

    Contributors

    1

    Total contributors

    Open Issues

    607

    Generated Insights

    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