iCloud to Immich

Hier beschreibe ich, wie man seine Videos, die man vielleicht aus Apples Fotos.app exportiert hat, sorgenfrei mit korrekten Metadaten wie GPS Position und HDR mit Hile von FFmpeg von .mov in .mp4 umwandeln kann.

Das Umwandeln der Videos hat mich ein wenig Zeit gekostet. Erstens, weil ich erst etwas später erkannt habe, dass mein einfacher ffmpeg Befehl, nicht alle erforderlichen Exif- und Metadaten der .mov-Dateien mitkopiert hat.

Exportieren aus Photos.app

Das gewünschte Video oder das ganze Album auswählen und exportieren. Im Dialog die Haken bei Metadata und Ortsangaben (Location) setzen und einen Ort zum Speichern auswählen. Warten.

Umwandeln der Videos von .mov zu .mp4

Mit ein wenig Hilfe der Dokumentation, fish und der KI habe ich es dann hinbekommen, dass alle Videos aus .mov zu .mp4 umgewandelt wurden, mit h.246 kodiert und die Exif- sowie Metadaten übertragen werden. Dazu wird zusätzlich zu ffmpeg noch das exiftool benötigt. Dieses hat nicht nur bei der Überprüfung sondern auch nach der Umwandlung geholfen, die korrekten Exifdaten einzutragen, bzw. zu übertragen.

Das shell-Skript für macOS und Linux (convert-videos.sh)

#!/bin/bash

# 1. Backup-Ordner erstellen
mkdir -p original_movs

# 2. Schleife durch alle .mov Dateien (Groß-/Kleinschreibung beachten)
for f in *.[mM][oO][vV]; do
    # Prüfen, ob Dateien existieren
    [ -e "$f" ] || continue

    filename="${f%.*}"
    echo -e "\n\033[0;36m>>> Verarbeite: $f\033[0m"

    # 3. FFmpeg Konvertierung
    # -map 0:v -map 0:a extrahiert nur Video und Audio (verhindert 'mebx' Fehler)
    # -map_metadata 0 übernimmt die globalen Tags (GPS, Modell)
    ffmpeg -i "$f" -map 0:v -map 0:a -map_metadata 0 -c:v libx264 -crf 23 -preset medium -c:a copy -movflags use_metadata_tags "${filename}.mp4"

    # 4. ExifTool Metadaten-Synchronisation
    # Schreibt das 2023er Datum in die MP4-Header
    echo -e "\033[0;33mSynchronisiere Datum für Immich...\033[0m"
    exiftool -overwrite_original -P "-CreateDate<CreationDate" "-ModifyDate<CreationDate" "-Track*Date<CreationDate" "-Media*Date<CreationDate" "${filename}.mp4"

    # 5. Original verschieben
    mv "$f" original_movs/
done

echo -e "\n\033[0;35mAlle Dateien fertig! Originale liegen in 'original_movs'.\033[0m"
  1. Datei erstellen: Erstelle eine Datei namens convert-videos.sh im Ordner deiner Videos.
  2. Berechtigungen setzen: Du musst das Skript ausführbar machen. Öffne das Terminal im Ordner und gib ein: chmod +x convert-videos.sh
  3. Skript starten: ./convert-videos.sh

Das PowerShell-Skript (konvertiere-videos.ps1)

# 1. Backup-Ordner erstellen, falls er noch nicht existiert
if (!(Test-Path "original_movs")) { New-Item -ItemType Directory -Name "original_movs" }

# 2. Alle .mov Dateien im aktuellen Verzeichnis suchen
$dateien = Get-ChildItem -Filter *.mov

Write-Host "Gefunden: $($dateien.Count) Dateien zum Verarbeiten." -ForegroundColor White

foreach ($datei in $dateien) {
    $ausgabeDatei = $datei.BaseName + ".mp4"
    Write-Host "`n>>> Verarbeite: $($datei.Name)" -ForegroundColor Cyan

    # 3. FFmpeg mit sicherem Mapping
    # -map 0:v (alle Videos), -map 0:a (alle Audios)
    # Wir lassen die inkompatiblen Datenströme (mebx) weg, nehmen aber die Tags mit
    ffmpeg -i $datei.Name -map 0:v -map 0:a -map_metadata 0 -c:v libx264 -crf 23 -preset medium -c:a copy -movflags use_metadata_tags $ausgabeDatei

    # 4. Metadaten-Korrektur (wie gehabt)
    Write-Host "Synchronisiere Datum..." -ForegroundColor Yellow
    exiftool -overwrite_original -P "-CreateDate<CreationDate" "-ModifyDate<CreationDate" "-Track*Date<CreationDate" "-Media*Date<CreationDate" $ausgabeDatei

    # 5. Verschieben
    Move-Item $datei.Name "original_movs\"
    
    Write-Host "Erfolg: $ausgabeDatei ist bereit für Immich." -ForegroundColor Green
}

Write-Host "`nAlle Dateien fertig! Originale liegen in 'original_movs'." -ForegroundColor Magenta

Ausführung unter Windows (mit PowerShell ISE)

Die PowerShell ISE ist auf jedem Windows-System vorinstalliert und ideal, um das Skript schnell und sicher auszuführen.

  1. PowerShell ISE öffnen:
  1. Skript einfügen:
  1. Ordnerpfad festlegen:
  1. Skript starten:

Erklärungen der einzelnen Befehle

1. Der FFmpeg-Befehl

ffmpeg -i input.mov -map 0 -map_metadata 0 -c:v libx264 -crf 23 -preset medium -c:a copy -movflags use_metadata_tags output.mp4

oder

ffmpeg -i input.mov -map 0:v -map 0:a -map_metadata 0 -c:v libx264 -crf 23 -preset medium -c:a copy -movflags use_metadata_tags output.mp4

2. Der ExifTool-Befehl

exiftool "-CreateDate<CreationDate" ... output.mp4

3. Fehlerbehebung bei Apple/iPhone Dateien

Wenn du iPhone-Videos konvertierst, stößt du auf den Fehler Could not find tag for codec none in stream #2. Das liegt an Apple-Metadaten-Strömen (mebx), die nicht MP4-kompatibel sind.

Lösung im Vergleich:

Warum -map 0:v -map 0:a?

Dieser Befehl filtert die "toten" Datenströme heraus, die den MP4-Container zum Absturz bringen würden, behält aber die volle Videoqualität und alle Tags (GPS, Kamera-Modell), die Immich für die Karte und die Timeline benötigt.

Warum kein GPU-Encoding (NVENC)?

Das Hardware-Encoding via Nvidia (NVENC) ist zwar extrem schnell, aber deutlich weniger effizient. In Tests wurde eine Datei von 63 MB mit dem CPU-Skript auf 27 MB geschrumpft, während NVENC nur auf 55 MB kam. Für die Langzeitarchivierung in Immich ist die CPU-Variante daher die bessere Wahl.

Zudem bietet der CPU-Encoder libx264 eine stabilere Beibehaltung von HDR-Flags (HLG), was bei GPU-Encodern je nach Treiberversion manchmal zu Problemen führen kann.

Hochladen der Videos zu Immich mit dem immich-go Kommandozeilenprogramm

immich-go

image.png


Revision #6
Created 2026-01-23 21:41:13 UTC by Carsten
Updated 2026-02-18 12:27:39 UTC by Carsten