What happens to your PDF
A PDF doesn’t store paragraphs. It stores runs of text and where each one sits on the page, which is why copying text out of a PDF so often brings page numbers, broken lines and half-words with it. Before a voice can read it, the page has to be rebuilt the way a reader sees it:
| Step | What it does |
|---|---|
| Lines and columns | Runs on the same baseline become a line; a two-column page is read down each column in turn. Ligatures (fi, fl) become plain letters. |
| Running headers and footers | A line near the top or bottom that repeats across the pages, with only its page number changing, is left out. |
| Page numbers | “12”, “xii”, “Page 12 of 300” and “— 12 —” at the edge of a page are left out. |
| Footnotes | Small type below the last line of body text, and the raised markers pointing to it, are left out unless you ask for them. |
| Paragraphs | A new paragraph starts at an indent, a wider gap, a change of type size, or after a short line that ends a sentence. A paragraph carries on over a page break. |
| Hyphenation | “narra-” at a line’s end and “tion” on the next become “narration”; a real compound like “Anglo-Saxon” keeps its hyphen. |
| Chapters | From the bookmarks, or from headings in bigger type and “Chapter” lines. A drop cap (a big first letter) joins its word. |
| Speech | Each paragraph is tidied for the voice (abbreviations, numbers, symbols, web addresses), then read by Kokoro-82M on your graphics card or processor. |
Which PDFs work best
- Best: PDFs exported from Word, Google Docs, Scrivener, InDesign or Vellum, and ebooks saved as PDF. They have clean text and usually bookmarks.
- Good: reports, essays and public-domain books from archives that include a text layer. Check the preview: old OCR can carry spelling errors that the voice will read as written.
- Hard: magazines, brochures and slide decks (text boxes in no fixed order), and pages heavy with tables, maths or code.
- Won’t work: scans without a text layer, and DRM-locked PDFs.
Have the manuscript as a Word file or EPUB too? Those keep their structure better than any PDF: use text to audiobook or EPUB to audiobook. To estimate the finished length first, the manuscript analyzer counts words and chapters, and the pronunciation guide maker collects names the voice should say right.
Where it runs
| Where | Download (once) | Speed |
|---|---|---|
| Graphics card (WebGPU) | about 330 MB | usually faster than real time |
| Processor (WebAssembly) | about 93 MB | about 2–3 × the audio’s length |
The voice model is cached by your browser after the first download, so later books start straight away and work offline.