Read, write and manipulate EPUB files via reader/writer API; auto-links stylesheets, offers CSS DSL and presets (or raw CSS), includes reader UI rendering via platform WebView, lazy resource loading.
A Kotlin Multiplatform library for reading, writing, and manipulating EPUB files.
A KMP fork of epub4j-kotlin (which itself forked epublib). All Java/JVM-only code in the fork has been replaced with multiplatform equivalents:
You can try the eReader sample in your browser, or browse the API reference & recipes.
You can download sample EPUBs here.
// in your shared module's build.gradle.kts
kotlin {
sourceSets {
commonMain.dependencies {
implementation("com.darkrockstudios:epub4kmp-core:0.1.0")
}
}
}
Pre-release. The API is stabilizing; expect breaking changes before 1.0.
import io.documentnode.epub4kmp.epub.EpubReader
import okio.FileSystem
import okio.Path.Companion.toPath
val book = EpubReader().readEpub(FileSystem.SYSTEM, "my-book.epub".toPath())
println(book.metadata.firstTitle)
for (author in book.metadata.getAuthors()) {
println("${author.firstname} ${author.lastname}")
}
for (resource in book.spine.getSpineReferences()) {
println(resource.resource?.href)
}
You can also read from any okio Source (e.g. an in-memory Buffer or a network
stream):
val book = EpubReader().readEpub(buffer /* okio.Source */)
import io.documentnode.epub4kmp.domain.Author
import io.documentnode.epub4kmp.domain.Book
io.documentnode.epub4kmp.domain.MediaTypes
io.documentnode.epub4kmp.domain.Resource
io.documentnode.epub4kmp.epub.EpubWriter
okio.FileSystem
okio.Path.Companion.toPath
book = Book().apply {
metadata.addTitle()
metadata.addAuthor(Author(, ))
metadata.language =
ch1 = Resource(
id = ,
= .trimIndent().encodeToByteArray(),
href = ,
).apply { mediaType = MediaTypes.XHTML }
addSection(, ch1)
}
FileSystem.SYSTEM.write(.toPath()) {
EpubWriter().write(book, )
}
Stylesheets registered via Book.addStylesheet are written into the EPUB and
auto-linked from every XHTML page at write time — you don't have to inject
<link> tags yourself.
import io.documentnode.epub4kmp.domain.Stylesheets
book.addStylesheet(Stylesheets.defaultReader())
defaultReader() is an opinionated serif reading style: indented paragraphs
(except the first in each section), generous line-height, chapter breaks
before <h1>.
A narrow typed builder covers the common ebook properties (typography,
spacing, page breaks) with a property(...) / raw(...) escape hatch for
anything else:
import io.documentnode.epub4kmp.domain.stylesheet
book.addStylesheet(stylesheet {
body {
fontFamily("Georgia, \"Times New Roman\", serif")
lineHeight(1.5)
margin("1em")
}
paragraph { textIndent("1.5em"); margin("0") }
firstParagraph { textIndent("0") } // p:first-of-type
paragraphFirstLine { fontVariant() }
heading() { fontSize(); pageBreakBefore() }
blockquote { margin(); fontStyle() }
raw()
})
import io.documentnode.epub4kmp.domain.Stylesheet
book.addStylesheet(Stylesheet(
// Omit `href` to use Stylesheet.DEFAULT_HREF, a namespaced path that
// won't collide with stylesheets a real EPUB might already ship at
// common paths like `styles/book.css`.
css = """
body { font-family: serif; line-height: 1.5; }
p { text-indent: 1.5em; margin: 0; }
""".trimIndent(),
))
The default EpubWriter runs a BookProcessorPipeline that includes
StylesheetLinker. To skip the auto-link step (e.g. you've hand-authored
your own <link> tags), pass your own processor:
import io.documentnode.epub4kmp.epub.BookProcessor
EpubWriter(BookProcessor.IDENTITY_BOOKPROCESSOR).write(book, sink)
epub4kmp-compose-ui)A sibling module ships a Compose Multiplatform UI layer for displaying an
already-loaded Book in a real reader. Targets are a subset of core:
JVM/Desktop, Android, iOS arm64 + simulator — native and wasmJs are not
supported. Rendering is delegated to a platform WebView on each target via
ComposeNativeWebview,
so chapter CSS, embedded fonts, and inline images all render at full fidelity.
commonMain.dependencies {
implementation("com.darkrockstudios:epub4kmp-core:0.1.0")
implementation("com.darkrockstudios:epub4kmp-compose-ui:0.1.0")
}
The batteries-included EpubReader composable wires a TOC drawer, prev/next
controls, and a styled chapter surface around a Book:
import io.documentnode.epub4kmp.compose.EpubReader
import io.documentnode.epub4kmp.domain.Stylesheets
@Composable
fun ReaderScreen(book: Book) {
// Optional — gives the rendered chapters a readable serif default.
remember(book) { book.addStylesheet(Stylesheets.defaultReader()) }
EpubReader(book = book, modifier = Modifier.fillMaxSize())
}
If you want to lay out the chrome yourself, the building blocks (EpubContent,
TableOfContents, CoverImage, MetadataCard) are public; EpubReader is
just one way to wire them together.
Pass a list of MediaTypes to readEpub to keep those resources unloaded until
their bytes are first accessed — useful for large books with many images:
val book = EpubReader().readEpub(
fileSystem = FileSystem.SYSTEM,
zipPath = "huge-book.epub".toPath(),
lazyLoadedTypes = listOf(MediaTypes.JPG, MediaTypes.PNG),
)
./gradlew build # all targets, runs JVM tests
./gradlew jvmTest # JVM smoke test
./gradlew iosSimulatorArm64Test # macOS host only
iOS Kotlin/Native compilation works on every host; running the iOS tests requires a macOS host with Xcode.
Source / SinkZipFile random-access / ZipInputStream streaming) and writingXmlWriter writes)kotlin.uuid.Uuid| Target | Status |
|---|
| JVM (incl. Android) | ✅ Tested on Linux, macOS, and Windows |
| iosArm64, iosSimulatorArm64 | ✅ Compiles; simulator tests run on a macOS host |
| macosArm64 | ✅ Compiles |
| linuxX64, linuxArm64 | ✅ Compiles |
| mingwX64 (Windows native) | ✅ Compiles |
| JS / wasmJs / Android native | Not yet enabled — depends on the libraries above |
Surfaced from shared tags and platforms — no rankings paid for.