kovi

Reading dashboard for your KOReader statistics.

  • ghcr.io/hsinghhira/kovi:latest
  • v2026.10.09
  • Updated 10 Nov 2026
  • port 6725
  • amd64 · arm64
  • Media

Open the app

Web App

http://localhost:6725/

About kovi

kovi turns your KOReader history into a reading dashboard: your library, progress, reading time by day and hour, highlights and covers. Import KOReader's statistics file, or let the kovi plugin on your e-reader send it on its own.

Features

  • Library with covers, progress and time spent per book
  • Reading-time heatmaps and graphs
  • Highlights and notes from your books
  • A KOReader plugin that syncs with a one-time pairing code
  • Exports and backups

How to use

  1. Open kovi from your dashboard.
  2. Upload statistics.sqlite3 from your KOReader, or install the kovi plugin on the e-reader and pair it.
  3. Browse your books, reading time and highlights.

Before you install

Nothing to set. kovi has no sign-in: anyone who can reach it can read your library and download backups, so keep it on your home network or behind a reverse proxy with a login. The KOReader plugin endpoints are protected separately, with one-time pairing codes and a token per device.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone, for reading-time charts. It is filled in from your ZimaOS time zone.

Covers

VariableDefault valueDescription
GOOGLE_BOOKS_API_KEY—A Google Books API key, for better cover and book lookups.
CALIBRE_COVER_RESOLVERautoHow covers are looked up with Calibre: auto, or off.
COVER_WORKER_CONCURRENCY2How many covers are looked up at once (1 to 4).

Uploads

VariableDefault valueDescription
MAX_FILE_SIZE_MB100The largest statistics file you can upload, in MB.

Server

VariableDefault valueDescription
TRUST_PROXY0Set to 1 behind a reverse proxy, so kovi sees visitors' addresses.
docker-compose.yml
name: kovi

services:
  kovi:
    image: ghcr.io/hsinghhira/kovi:latest
    container_name: kovi
    restart: unless-stopped
    stop_grace_period: 20s
    network_mode: bridge
    environment:
      - TZ=$TZ
    ports:
      - target: 3000
        published: "6725"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/data
        target: /app/data
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "curl", "-fsS", "-o", "/dev/null", "http://127.0.0.1:3000/"]
      interval: 30s
      timeout: 5s
      retries: 3
      start_period: 20s
    deploy:
      resources:
        limits:
          cpus: "1.00"
          memory: 512M
        reservations:
          cpus: "0.00"
          memory: 48M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kovi/icon.png
    x-casaos:
      id: com.icestore.kovi
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone, for reading-time charts. It is filled in from
              your ZimaOS time zone.
      ports:
        - container: "3000"
          description:
            en_US: kovi web app and KOReader plugin endpoints, published on host as 6725
      volumes:
        - container: /app/data
          description:
            en_US: The database, uploads and cached book covers.

x-casaos:
  id: com.icestore.kovi
  architectures:
    - amd64
    - arm64
  main: kovi
  author: HSinghHira
  category: Media
  developer: mdaleo404
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/kovi/icon.png
  title:
    en_US: kovi
  tagline:
    en_US: Reading dashboard for your KOReader statistics.
  description:
    en_US: >-
      Visit: [https://icestore.hsinghhira.me/app/kovi/](https://icestore.hsinghhira.me/app/kovi/) for full details


      kovi turns your KOReader history into a reading dashboard: your library,
      progress, reading time by day and hour, highlights and covers. Import
      KOReader's statistics file, or let the kovi plugin on your e-reader send
      it on its own.


      **Features**


      - Library with covers, progress and time spent per book

      - Reading-time heatmaps and graphs

      - Highlights and notes from your books

      - A KOReader plugin that syncs with a one-time pairing code

      - Exports and backups


      **How to use?**


      1. Open kovi from the Zima OS dashboard.


      2. Upload statistics.sqlite3 from your KOReader, or install the kovi
         plugin on the e-reader and pair it.


      3. Browse your books, reading time and highlights.
  tips:
    before_install:
      en_US: >-
        1. Nothing to set. Start the installation.


        2. kovi has no sign-in: anyone who can reach it can read your library.
           Keep it on your home network, and never open its port to the
           internet.


        3. Open kovi and upload KOReader's statistics.sqlite3, or download the
           KOReader plugin from kovi and pair your e-reader with the code it
           shows.
  index: /
  port_map: "6725"
  scheme: http
  is_uncontrolled: false
  version: "2026.10.09"
  update_at: "2026-11-10"
  release_notes:
    en_US: |-
      - First IceStore version: kovi 2026.10.09, built from upstream's release with its own Dockerfile (Node 22 and Calibre for covers); upstream publishes no image.
      - Port 6725; the data folder is /DATA/AppData/kovi/data.
  repo: "https://git.sysmd.uk/mdaleo404/kovi"
  support: "https://git.sysmd.uk/mdaleo404/kovi/issues"
  docs: "https://git.sysmd.uk/mdaleo404/kovi"

Install kovi

Something not working with kovi?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all