aacamara/ai-video-editor

Was macht ai-video-editor?

KI-gestützte Videobearbeitung für Claude Code – Whisper-Transkription, Highlight-Reels, Xfade-Übergänge, Audiomischung und plattformübergreifender Export für YouTube/TikTok/Reels.

Übersicht

Dieses Skill ermöglicht Claude Code, Videos automatisiert zu bearbeiten und zu exportieren:

• Whisper-Transkription: Nutzt OpenAIs Whisper-Modell zur Transkription von Audio
• Highlight-Reels: Erstellt automatisch Zusammenstellungen auf Basis von Transkriptionen
• Xfade-Übergänge: Fügt weiche Überblendungen zwischen Clips hinzu
• Audiomischung: Mischt Hintergrundmusik oder Sprachspuren mit FFmpeg
• Plattformexport: Optimiert Videos für YouTube, TikTok und Instagram Reels

Voraussetzungen

• Claude Code (installiert und konfiguriert)
• FFmpeg (Version 4.0 oder höher) – auf dem System installiert (macOS: brew install ffmpeg, Linux: apt install ffmpeg)
  Windows: Download von ffmpeg.org und Pfad zu PATH hinzufügen.
• Python 3.8+ mit openai-whisper installiert (pip install openai-whisper)
• Optional: OpenAI-API-Key (falls Whisper über die API genutzt wird; ansonsten lokal ausgeführt).

Installation

1. Klone das Repository:

   git clone https://github.com/aacamara/ai-video-editor
   cd ai-video-editor
   

2. Installiere Python-Abhängigkeiten:

   pip install -r requirements.txt
   

3. Stelle sicher, dass FFmpeg installiert ist (siehe Voraussetzungen).

Verwendung

Transkribieren eines Videos

python transcribe.py --input video.mp4

Dies erzeugt eine transcription.json mit Zeitstempeln und Text.

Highlight-Reel erstellen

python create_highlights.py --input video.mp4 --transcription transcription.json --keywords "wichtig, highlight"

Extrahiert Clips, die die angegebenen Schlüsselwörter enthalten.

Übergänge hinzufügen

python add_transitions.py --input clips/*.mp4 --output final.mp4 --transition xfade --duration 1.0

Fügt Xfade-Übergänge zwischen allen Clips im clips/-Ordner hinzu.

Für Plattform exportieren

python export.py --input final.mp4 --platform youtube
python export.py --input final.mp4 --platform tiktok
python export.py --input final.mp4 --platform reels

Optimiert Auflösung, Seitenverhältnis und Codec für die jeweilige Plattform.

Konfiguration

Umgebungsvariablen:

Variable	Beschreibung	Standardwert
OPENAI_API_KEY	OpenAI-API-Key für Whisper (optional)	–
MAX_CLIP_DURATION	Maximale Dauer eines Highlight-Clips in Sekunden	15
OUTPUT_DIRECTORY	Ausgabeverzeichnis für exportierte Videos	./output

Lizenz

MIT-Lizenz – siehe LICENSE-Datei.

Beiträge

Beiträge sind willkommen! Bitte öffnen Sie ein Issue oder einen Pull Request auf GitHub.