metadata_audio 0.4.0 changelog

0.4.0 #

Fixed: MP4 chpl (Nero chapter list) parsing now supports audiobook chapter extraction from files that expose chapter timing via chapter time base metadata.
Fixed: Chapter timestamp conversion now infers time base from file timing data instead of relying on a hardcoded scale, restoring full chapter lists (e.g. 73 chapters) for affected M4B files.
Fixed: MP4 parser now reads chpl atoms under udta and emits normalized chapter ranges (start/end) in milliseconds.
Fixed: 64-bit MP4 integer parsing overflow guard for large files / version-1 atom fields.
Improved: URL-based MP4 parsing reliability for large files by expanding tail prefetch windows for moov discovery in HTTP tokenizers.

Fixed: MP4 chapter extraction now works reliably with URL-based tokenizers by prefetching the entire moov atom when it exceeds the initial prefetch window.
Feat: Implemented consolidated HTTP range requests in HttpBasedTokenizer, reducing the number of network requests by up to 90% for large metadata blocks.
Feat: Added retry logic with exponential backoff to HTTP tokenizers to handle transient network errors.
Fixed: Improved MP4 chapter timing accuracy by using the chapter track's own Time-to-Sample (STTS) table instead of approximate byte-offset correlation.

Fixed: Auto-initialize parser factory to prevent "Field '_parserFactory' has not been initialized" error
Added: createDefaultParserFactory() function for creating a factory with all format loaders
Added: Exports for all format loaders (MpegLoader, FlacLoader, etc.) for custom configurations
Docs: Added initialization section to README documenting auto-init and custom setup

Initial stable release with comprehensive audio metadata support
Multi-format support: MP3, FLAC, Ogg Vorbis, MP4, WAV, AIFF, APE, ASF, Matroska, Musepack, WavPack, DSF, DSDIFF
Full ID3 support: ID3v1, ID3v2.2, ID3v2.3, ID3v2.4
Chapter/track boundary extraction for audiobooks and podcasts
Smart URL parsing with automatic strategy selection
Streaming support for remote files