coilyco-flight-deck/agentic-os

Was macht agentic-os?

Inspiziere und transformiere Audio oder Video mit FFmpeg und ffprobe. Verwende es für Transkodierung, Trimmen, Remuxen, Frame- oder Audioextraktion, Filter, Untertitel, Thumbnails und Mediendiagnostik.

Überblick

Diese Fähigkeit bietet einem KI-Agenten direkten Zugriff auf FFmpeg und ffprobe.

• Inspiziere Mediendateien (Format, Codecs, Metadaten, Dauer etc.)
• Transkodiere zwischen verschiedenen Formaten und Codecs
• Trimme Medien auf bestimmte Start- und Endzeiten
• Remuxe Container (z. B. MKV zu MP4) ohne Re-Encoding
• Extrahiere Einzelbilder, Audiospuren oder Untertitel
• Wende Filter an (Skalierung, Farbkorrektur, Rauschunterdrückung, etc.)
• Erzeuge Thumbnails in verschiedenen Größen und Zeitstempeln
• Diagnostiziere Dateien mit ffprobe (Bitrate, Stream-Informationen, Fehler)

Voraussetzungen

• FFmpeg und ffprobe müssen auf dem System installiert und im PATH verfügbar sein.
• Getestet mit FFmpeg-Version 4.4 und höher.

Verwendung

Die Fähigkeit erwartet Eingaben als strukturierte JSON-Objekte, die den gewünschten Vorgang und die relevanten Parameter beschreiben.

Inspiziere Mediendatei

{
  "action": "inspect",
  "input": "/pfad/zu/datei.mp4"
}

Transkodiere

{
  "action": "transcode",
  "input": "/pfad/zu/input.mkv",
  "output": "/pfad/zu/ausgabe.mp4",
  "options": {
    "codec:v": "libx264",
    "codec:a": "aac",
    "bitrate:v": "2M",
    "preset": "medium"
  }
}

Trimme Video

{
  "action": "trim",
  "input": "/pfad/zu/input.mp4",
  "output": "/pfad/zu/ausgabe.mp4",
  "start": "00:01:30",
  "end": "00:04:15"
}

Extrahiere Audiospur

{
  "action": "extract-audio",
  "input": "/pfad/zu/input.mkv",
  "output": "/pfad/zu/audio.mp3",
  "options": {
    "stream": 1,
    "codec:a": "libmp3lame",
    "bitrate:a": "320k"
  }
}

Erzeuge Thumbnail

{
  "action": "thumbnail",
  "input": "/pfad/zu/input.mp4",
  "output": "/pfad/zu/thumbnail.jpg",
  "time": "00:05:00",
  "width": 640
}

Diagnose

{
  "action": "diagnose",
  "input": "/pfad/zu/datei.ts"
}

Konfiguration

Umgebungsvariablen (optional):

• FFMPEG_PATH: Pfad zur FFmpeg-Binärdatei (Standard: ffmpeg)
• FFPROBE_PATH: Pfad zur ffprobe-Binärdatei (Standard: ffprobe)
• TEMP_DIR: Temporäres Verzeichnis für Zwischendateien (Standard: /tmp)

Beispiele

• Transkodiere eine lange MKV-Datei in ein kompatibles MP4 für das Web.
• Trimme die letzten 30 Sekunden einer Aufnahme.
• Extrahiere die englische Tonspur aus einem mehrsprachigen Film.
• Erstelle einen Satz von Thumbnails für eine Videovorschau.
• Überprüfe die Integrität und Details einer beschädigten Videodatei.

Hinweise

• Alle Operationen sind blockierend; bei großen Dateien kann die Ausführung einige Zeit in Anspruch nehmen.
• Der Agent sollte dem Benutzer klare Rückmeldungen über Erfolg oder Fehler geben.
• Fehlerbehandlung: ffmpeg/ffprobe können fehlschlagen, wenn ungültige Optionen oder fehlende Codecs übergeben werden. Der Agent sollte dies abfangen und hilfreiche Fehlermeldungen anzeigen.
• Achte auf Ressourcenverbrauch (CPU, Arbeitsspeicher, Festplattenplatz) bei großen Dateien.

Lizenz

MIT