Skip to content

fix: use Alpine 3.24 to get ffmpeg 8.1.2 for correct HEIC transcoding - #195

Merged
SmilyOrg merged 1 commit into
mainfrom
bug-incorrect-transcode-of-heic-file
Aug 9, 2026
Merged

fix: use Alpine 3.24 to get ffmpeg 8.1.2 for correct HEIC transcoding#195
SmilyOrg merged 1 commit into
mainfrom
bug-incorrect-transcode-of-heic-file

Conversation

@SmilyOrg

@SmilyOrg SmilyOrg commented Aug 9, 2026

Copy link
Copy Markdown
Owner

Problem

The Docker build produces corrupted/wrong thumbnails for HEIC files, showing blank/white areas instead of the actual image content.

Root Cause

Alpine 3.23 ships ffmpeg 8.0.1 which has a bug in HEIC tile assembly and orientation handling. When generating thumbnails from HEIC files:

  • Only the first tile is output (2016×1512) instead of assembling all tiles
  • The tile is incorrectly rotated 90° during scaling
  • Produces a portrait image (183×256) instead of the correct landscape (256×192)

Fix

Upgrade to Alpine 3.24 which ships ffmpeg 8.1.2 — this fix resolves the HEIC tile assembly and orientation issues.

Verification

# Alpine 3.23 (broken):
ffmpeg -i IMG_3880.HEIC -vframes 1 -filter_complex "scale=..." -c:v pam ...
# → WIDTH 183, HEIGHT 256 (rotated, wrong)

# Alpine 3.24 (fixed):
# → WIDTH 256, HEIGHT 192 (correct)

Alpine 3.23 ships ffmpeg 8.0.1 which has a bug where HEIC tile
assembly and orientation handling are broken during thumbnail generation.
This causes thumbnails to be rotated 90° and show incorrect content.

Alpine 3.24 ships ffmpeg 8.1.2 which fixes this issue.

Signed-off-by: mlunar
@SmilyOrg
SmilyOrg marked this pull request as ready for review August 9, 2026 17:36
@SmilyOrg
SmilyOrg merged commit 6b820bd into main Aug 9, 2026
4 checks passed
@SmilyOrg
SmilyOrg deleted the bug-incorrect-transcode-of-heic-file branch August 9, 2026 17:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant