v2.8.0 - Auto-Extract Embedded Cover Art (2025-01-XX)
๐จ New Features
Auto-Extract Embedded Cover Art from Audio Files
Implements Issue #5: Audiobook Forge now automatically extracts embedded cover art from MP3/M4A files when no standalone cover file exists.
What's New:
- ๐ผ๏ธ Automatic Fallback: If no
cover.jpgorcover.pngis found, the tool extracts cover art embedded in the first audio file - ๐๏ธ Configurable: New
metadata.auto_extract_coverconfig option (defaults totrue) - ๐ฆ Format Support: Works with MP3 (ID3 APIC frames) and M4A/M4B (mp4ameta artwork)
- ๐งน Clean: Automatically cleans up temporary extracted covers after processing
- โ Smart Priority: Standalone cover files still take precedence (preserves existing behavior)
How It Works:
- Scanner checks for standalone cover files (cover.jpg, folder.jpg, etc.)
- If none found, extracts embedded cover from first MP3/M4A file
- Uses extracted cover for final M4B metadata
- Cleans up temporary
.extracted_cover.jpgafter processing
Configuration:
metadata:
auto_extract_cover: true # Default: enabledBenefits:
- โจ Audiobooks from Audible/iTunes with embedded covers "just work"
- ๐ซ No need to manually extract and save cover.jpg
- ๐ Fully backward compatible
- โ๏ธ Can be disabled via config if needed
๐ Implementation Details
- Added 3 new cover extraction functions in
src/audio/metadata.rs - Updated Scanner to extract covers during directory scanning phase
- Uses existing
id3andmp4ametadependencies - Extracts to temporary file, cleaned after AtomicParsley embeds into M4B
๐ Links
Full Changelog: v2.7.0...v2.8.0