v1.5.1 — fix HEVC VideoToolbox hvc1 tag (#48) (#49)

Author: epheterson

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 1.5.1 — 2026-05-25
+
+### Fixes
+- **HEVC VideoToolbox output now always uses Apple-compatible hvc1 tag (#48)**. ffmpeg defaults to hev1 for HEVC, which Apple's decoder rejects. The wrapper now injects `-tag:v hvc1` when encoding HEVC via VideoToolbox if the caller doesn't specify it.
+
 ## 1.5.0 — 2026-05-19
 
 ### Features

README.md

@@ -95,7 +95,18 @@ Real-time monitoring at `http://your-mac:8420`:
 immich-accelerator dashboard
 ```
 
-Shows service health, processing progress with live rates and ETAs, Apple Silicon hardware utilization, and system metrics. Mobile-friendly — check from your phone.
+Shows service health, processing progress with live rates and ETAs, Apple Silicon hardware utilization, and system metrics. Mobile-friendly -- check from your phone.
+
+The dashboard and setup use the Immich API for job status and queue control. Create an API key from an **admin** account in Administration > API Keys with these permissions:
+
+| Permission | Used by | Why |
+|-----------|---------|-----|
+| `job.read` | Dashboard | Show queue activity (active/waiting counts) |
+| `job.create` | Dashboard | Re-queue button |
+| `asset.read` | Setup | Detect upload library path |
+| `library.read` | Setup | Detect external library paths |
+
+All `job.*` and `library.*` endpoints require admin access. If the dashboard shows "API key invalid," make sure the key was created by an admin user.
 
 ![Dashboard](docs/dashboard.png)
 

VERSION

@@ -1 +1 @@
-1.5.0
+1.5.1

immich_accelerator/ffmpeg-wrapper.sh

@@ -11,6 +11,8 @@ REAL_FFMPEG="/opt/homebrew/bin/ffmpeg"
 
 ARGS=("$@")
 USE_HW=false
+USE_HEVC=false
+HAS_HEVC_TAG=false
 NEW_ARGS=()
 
 for ((i=0; i<${#ARGS[@]}; i++)); do
@@ -30,6 +32,7 @@ for ((i=0; i<${#ARGS[@]}; i++)); do
                 NEW_ARGS+=("$arg" "hevc_videotoolbox")
                 ((i++))
                 USE_HW=true
+                USE_HEVC=true
                 continue
                 ;;
         esac
@@ -41,10 +44,22 @@ for ((i=0; i<${#ARGS[@]}; i++)); do
         continue
     fi
 
+    # Track if -tag:v is already specified (including stream-specific -tag:v:0 etc.)
+    [[ "$arg" == -tag:v* ]] && HAS_HEVC_TAG=true
+
     NEW_ARGS+=("$arg")
 done
 
 if [[ "$USE_HW" == true ]]; then
+    # Ensure HEVC output uses hvc1 tag (Apple-compatible).
+    # hev1 (ffmpeg default) stores parameter sets in-band — Apple's
+    # decoder rejects it. Immich usually passes -tag:v hvc1 itself,
+    # but if it's absent we inject it before the output filename.
+    if [[ "$USE_HEVC" == true && "$HAS_HEVC_TAG" == false ]]; then
+        len=${#NEW_ARGS[@]}
+        LAST="${NEW_ARGS[$((len-1))]}"
+        NEW_ARGS=("${NEW_ARGS[@]:0:$((len-1))}" "-tag:v" "hvc1" "$LAST")
+    fi
     exec "$REAL_FFMPEG" -hwaccel videotoolbox "${NEW_ARGS[@]}"
 else
     exec "$REAL_FFMPEG" "${NEW_ARGS[@]}"