github juanra/audiobook-forge v2.8.0
v2.8.0: Auto-Extract Embedded Cover Art

latest release: v2.8.1
6 hours ago

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.jpg or cover.png is found, the tool extracts cover art embedded in the first audio file
  • ๐ŸŽ›๏ธ Configurable: New metadata.auto_extract_cover config option (defaults to true)
  • ๐Ÿ“ฆ 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:

  1. Scanner checks for standalone cover files (cover.jpg, folder.jpg, etc.)
  2. If none found, extracts embedded cover from first MP3/M4A file
  3. Uses extracted cover for final M4B metadata
  4. Cleans up temporary .extracted_cover.jpg after processing

Configuration:

metadata:
  auto_extract_cover: true  # Default: enabled

Benefits:

  • โœจ 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 id3 and mp4ameta dependencies
  • Extracts to temporary file, cleaned after AtomicParsley embeds into M4B

๐Ÿ”— Links


Full Changelog: v2.7.0...v2.8.0

Don't miss a new audiobook-forge release

NewReleases is sending notifications on new releases.