Milo is a multi-user, self-hosted web-based ebook reader application that supports multiple ebook formats, keeps track of your reading progress and has a touch-friendly web interface.
  • Java 79.8%
  • JavaScript 17.9%
  • CSS 2.1%
  • HTML 0.2%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Christian Wiwie bf82f3ef62 fix(print): cluster matched images instead of global median for format detection
Real kids' books (epub 11252) mix interior scene art in every aspect —
96% of 119 images match no paper window, so median-over-all and the 40%
unmatched gate could never pass. The trim signal lives in the cover and
full-page illustrations: decide on the cluster of images that DO match
a window (>=3, one paper, median over matched only) and sample the
largest files first (cap 50), since ornaments are small.
2026-10-03 03:25:17 +02:00
docs/superpowers/specs docs(print): design spec for reflowable EPUB format detection 2026-10-02 22:58:43 +02:00
frontend fix(start): seal navbar-timeline sticky seam with 1px title overlap 2026-09-15 21:54:22 +02:00
gradle/wrapper * bumping deps 2025-05-29 14:44:57 +02:00
src fix(print): cluster matched images instead of global median for format detection 2026-10-03 03:25:17 +02:00
.dockerignore docs(deploy): add Docker deployment design and Compose/Traefik setup 2026-09-12 20:43:02 +02:00
.env.example docs(deploy): add Docker deployment design and Compose/Traefik setup 2026-09-12 20:43:02 +02:00
.gitignore perf(start): make legacy host migration opt-in and fix servlet registration 2026-09-12 20:43:00 +02:00
AGENTS.md docs: document docker compose deployment in AGENTS.md 2026-09-15 21:38:54 +02:00
build.gradle * made AI feature optional (milo.ai.enabled / 'ai' profile), added missing spring-boot-h2console module for boot 4 2026-09-07 23:21:17 +02:00
compose.yaml chore(deploy): persist print render cache across container restarts 2026-09-14 13:29:59 +02:00
Dockerfile chore(deploy): persist print render cache across container restarts 2026-09-14 13:29:59 +02:00
gradle.properties * added vaadin-dev dependency for vaadin 25 dev mode, bumped gradle daemon heap 2026-09-07 22:35:32 +02:00
gradlew * Initial commit 2024-02-17 07:57:03 +01:00
gradlew.bat * Initial commit 2024-02-17 07:57:03 +01:00
README.md perf(start): make legacy host migration opt-in and fix servlet registration 2026-09-12 20:43:00 +02:00
settings.gradle * Renamed project to milo-reader 2024-07-17 10:46:21 +02:00

Milo

Milo is a multi-user, self-hosted web-based ebook reader application that supports multiple ebook formats, keeps track of your reading progress and has a touch-friendly web interface.

Legacy document host migration

Normal startup does not scan or rewrite the library. For an old library whose stored document URIs still reference castleblack, run the app once with --milo.migrations.legacy-document-host=true, then remove the flag. The migration replaces castleblack with nuc.lan and saves only changed documents; null and already migrated URIs are left alone. Do not leave this flag enabled in Compose.