Zum Inhalt

SYS-04 – Videos mit ffmpeg wandeln und Metadaten mit ExifTool lesen

Im Handbuch vom 09.10.2026 erzeugt ffmpeg Videos und Vorschaubilder; ExifTool ermittelt Videometadaten, insbesondere die Eingangsgröße. Die frühere Matrixbezeichnung „ffmpeg/ffprobe“ ist historisch und keine aktuelle Installationsanweisung.

Fundort und Voraussetzungen

  • ffmpeg.exe im ImageConvert-Programmordner.
  • Unterordner exiftool mit dem zugehörigen Werkzeug; der gelesene Source erwartet exiftool\exiftool.exe unter dem Startpfad.
  • Kunden-JSON: fileExtensions.videoExtensions[] für Erkennung, mainFolder.video.rootFolder und mainFolder.video.subFolder[] für Ausgabe.
  • Unterstützte Codecs hängen von der tatsächlich gelieferten ffmpeg-Version ab. Die historischen Buildnamen im Manual sind keine allgemeine Empfehlung für aktuelle Downloads.

Konkrete Einrichtung

  1. Gewünschte Eingangs-Endung ohne Punkt in die vorhandene Videoliste aufnehmen, z. B. mp4; Überschneidungen mit der vorrangigen Bildliste beachten.
  2. Video-Ausgang mit Name, Aktivierung, Größe, Framerate und Format im vorhandenen Kundenobjekt konfigurieren.
  3. Optional JPG-/PNG-Vorschaubild über imageFormat wählen. Exakte Schreibweise beachten: framesPersec und imageFormat, nicht die alten Kleinschreibungen.
  4. Nach Syntax-/Pfadkontrolle kontrolliert neu starten. Ausgabe, Originalarchiv und Kundenlog getrennt betrachten.

Ausschnitt eines Videoausgangs:

{"name": "video_web\\", "active": true, "widthPx": 1280, "heightPx": 720, "framesPersec": 24, "format": "mp4", "imageFormat": "jpg", "schaltpfade": []}

Optionen, Standards und Ergebnisgrenzen

active ist Boolean. Maße sind nichtnegative Pixelwerte; 0/0 übernimmt die Eingangsgröße. framesPersec ist eine Zahl; 24 ist hier nur Beispiel. imageFormat erlaubt laut Manual "no", "jpg", "png". Ein allgemeiner Standard bei fehlenden Videooptionen ist hier nicht belegt. Größenregeln und unterstützte Ausgabeformate stehen bei VID-01, Vorschaubilder bei VID-02.

Der bestehende Projektbefund für Build 20261009 bestätigt drei konkrete H.264-Ziele mit 24 fps und JPG-/PNG-Vorschauen; daraus folgt weder allgemeine Codecunterstützung noch dieselbe Thumbnailgröße für jede Konfiguration. Der ältere Retest vom 31.08.2026 ist ebenfalls ein Einzelfall, kein Defaultvertrag.

Quellen

ImageConvert-4.pdf, 09.10.2026, physisch S. 5, 10–11, 15, 20–21, 48–49, 73. Source IC/Form1.cs Z. 183–196, 1208–1219 (statisch, Revisionliteral 20261013). Historische Ergebnisbelege: docs/ERGEBNIS_FEHLER_RETEST_BUILD_20261009.md, docs/ABSCHLUSS_MINITEST_BUILD_20261009.md; keine neue Laufprüfung.

Ausgänge aktivieren · Videoschaltpfade