EPUB 3 - Media Overlay (SMIL + MP3 narration)
An EPUB 3 with a real media overlay: a SMIL document ties three paragraph ids to clip ranges in an embedded MP3, and the package declares media:duration and media:active-class. The narration track is deliberately silent audio, so the fixture stays small and byte-identical on every run.
- mimetype
- container.xml
- content.opf
- nav.xhtml
- style.css
- chapter1.xhtml
- chapter1.smil
- narration-1.mp3
Specifications
- Seed
- 20260807
- Epub Version
- 3.0
- Overlay Docs
- 1
- Smil Pars
- 3
- Audio Format
- MPEG-1 Layer III, 64 kbps, 44.1 kHz mono
- Audio Seconds
- 1.202
- Media Duration
- 0:00:01.202
- Active Class
- -epub-media-overlay-active
- Audio Content
- digital silence
Testing contract
Expected to pass- Scenario
- Start read-aloud playback and follow the highlight through the chapter.
- Expected result
- Playback advances par by par, each of the three paragraphs is highlighted in turn via the declared active class, and the reader reports the same total length as media:duration.
What is a .epub file?
EPUB is the open e-book standard, a ZIP archive containing XHTML content documents, CSS, images, and a package manifest describing reading order and metadata. It supports reflowable text that adapts to screen size and is supported by most e-readers except Kindle natively. It is the dominant format for distributable e-books.
How to use this file
Use an example EPUB to test e-book parsing, ZIP-package and manifest handling, reading-order and metadata extraction, and rendering in e-reader applications.
How to use this file for testing
“EPUB 3 - Media Overlay (SMIL + MP3 narration)” is a deterministic Novus Examples fixture for Media accessibility, Conversion testing. Containers carrying several subtitle and audio tracks at once, with real language tags and the default, forced, hearing-impaired and visual-impaired flags actually set — for testing track pickers, accessibility menus, and the flag handling that only shows up when more than one track exists.
Documented properties for this file: seed 20260807. Compare results against paired or grouped companions on this page when present (clean↔damaged, searchable↔scanned, or format twins) so scores stay reproducible across runs.
Download the file once, keep the path stable in CI or local scripts, and treat the spec table as the contract: dimensions, seeds, field lists, and roles are intentional. Corrupt or invalid samples are labelled as such — expect parsers to fail loudly rather than silently accept them.
E-book fixtures are structured archives documented down to their spine and manifest. Test readers and converters, and where a valid↔intentionally-invalid pair exists, assert graceful handling of the malformed container.
Code examples
ebook-convert smil-single-track.epub out.pdf # Calibre
unzip -l smil-single-track.epub # EPUB is a ZIPRelated files
- epubEPUB 2.0.1 - NCX pageList with pageTargetsAn EPUB 2.0.1 that records print pagination the older way: an NCX pageList of pageTarget elements pointing at anchors in the text. The EPUB 2 counterpart of the EPUB 3 page-list nav, and what a converter has to translate between.
- epubEPUB 3 - MathML with altimg and alttext FallbackThe same equation carrying the fallbacks a reader without a MathML engine needs: an altimg raster, its declared dimensions and baseline offset, and an alttext reading of the formula for speech. For testing fallback selection and what a screen reader announces.
- epubEPUB 3 - Page List Navigation (pagebreak markers)An EPUB 3 carrying print-page navigation: a hidden page-list nav, matching pagebreak markers in the content with doc-pagebreak roles, and an equivalent NCX pageList. For testing go-to-page features and the page-number reporting that accessibility conformance asks for.
- mkvMulti-Track Audio — 5.1 Surround, One Tone per Channel (MKV)A 5.1 track with a different pitch in every channel: an A-major triad across L, R and C, a 60 Hz rumble in the LFE, and two higher tones in the surrounds. Channel order is the standard L, R, C, LFE, Ls, Rs. This makes channel-mapping bugs audible instead of theoretical. Downmix it to stereo and you should hear the triad plus the surrounds; if the centre and the LFE swap — a classic WAV-to-container ordering mistake — the result is unmistakable. Most 5.1 test files play the same content everywhere and cannot detect that at all.
- mkvMulti-Track Audio — Audio Description (MKV)A main audio track plus an audio-description track for blind and low-vision viewers, carrying the `visual_impaired` disposition. The description track is an octave and a bit below the main track, so selecting it is audible. Matroska has exactly one flag for this — there is no separate `descriptions` flag as there is in MP4 and in HTML's own track kinds — so a converter that maps `kind="descriptions"` onto Matroska has to pick this one, and a converter going the other way has to infer it. Both tracks are tagged `eng`, which is the realistic case and the awkward one: a picker that lists tracks by language shows two identical entries, and only the flags tell them apart. Broadcast and streaming compliance regimes increasingly require this track to be present and correctly flagged, and the flags are exactly what a naive `ffmpeg -c copy` remux drops.
- mkvMulti-Track Audio — Commentary Track (MKV)A feature track and a commentary track, separated only by the `comment` disposition. The third member of this group's flag set alongside audio description and dual language, and the one that most often ends up auto-selected by mistake — a player that picks the last matching English track rather than the default one starts the film on the commentary.
Generated by generation/ebooks_p7.py. Free for any use, no attribution required — license.