juanra/audiobook-forge v2.6.3

v2.6.3: Documentation Updates

on GitHub

📝 Documentation Updates

Updated README to document the ultra and maximum quality presets, and clarified quality preservation behavior to avoid misleading users about audio quality improvement.

What's Updated

Quality Preset Documentation:
Now properly documented with detailed specifications and accurate descriptions:

• low - 64kbps, 22050Hz, mono (smallest file size)
• medium - 96kbps, 44100Hz, stereo (balanced quality/size)
• high - 128kbps, 48000Hz, stereo (premium audiobook quality)
• ultra - 192kbps, 48000Hz, stereo (for music/theatrical productions) ✨
• maximum - 256kbps, 48000Hz, stereo (near-lossless quality) ✨
• source - Auto-detect from source files (default)

Important Clarifications:

• Smart Quality Detection now accurately described as "preserves source audio quality"
• Clarified that quality presets are for reducing file size or standardizing libraries
• Added important note: Higher bitrate presets won't improve quality that doesn't exist in source
• Removed misleading language suggesting higher presets "improve" quality

Troubleshooting Section Updated:

# First, check your source file quality
ffmpeg -i input.mp3

# The default preserves source quality (no upsampling/downsampling)
audiobook-forge build --root /path --quality source

# Note: Using a higher quality preset won't improve quality
# that doesn't exist in the source files

Key Understanding:
The tool preserves whatever quality exists in your source files. If your source is already compressed (e.g., 64kbps), encoding at a higher bitrate won't improve quality - it will just create a larger file with the same audio quality.

Files Modified

• README.md - Quality preset documentation and quality preservation clarifications
• CHANGELOG.md - v2.6.3 entry updated with accurate description

Full Changelog: v2.6.2...v2.6.3