Musik-Beat-Sync-Video (Beat-Mashup)
Erkenne mit librosa die Schläge der Hintergrundmusik, schneide das Bildmaterial hart auf die Schläge und füge Schlageffekte hinzu, um ein energiegeladenes Beat-Sync-Kurzvideo zu erstellen. Das Skript
skills/shared/scripts/beatsync.pywird für alles verwendet: Zähle Schläge nicht von Hand und füge keine Filter manuell hinzu – das Skript erledigt Beat-Erkennung, Intervallaufteilung, Material-Looping und Audio-Video-Synchronisation.
Für eine sanfte Diashow mit fester Bilddauer siehe slideshow-video; für ein Thema → AI-Bildunterschrift-Sprachausgabe-Film siehe auto-short-video.
Eingabe
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| Hintergrundmusik | Ja | Die Musikdatei, die den Takt vorgibt (je stärker der Rhythmus, desto besser; wenn nicht angegeben, nachfragen) |
| Material | Ja | Ein Satz Bilder und/oder kurze Clips (in Reihenfolge, werden in einer Schleife verwendet) oder ein Verzeichnis |
| Seitenverhältnis | Ja | Wenn der Benutzer oder die übergeordnete Aufgabe nicht explizit Quer- oder Hochformat (oder eine bestimmte Auflösung) angibt, muss vor der Erstellung nachgefragt werden und auf Bestätigung gewartet werden; darf nicht stillschweigend auf Basis von Plattform, Profil oder Standardwert bestimmt werden; bei eindeutiger Angabe nicht erneut nachfragen |
| Wechselfrequenz | Nein | Alle wie viele Schläge wechseln (Standard: alle 2 Schläge) |
| Effekt | Nein | zoom (Standard, Heranzoomen) / flash (weißes Aufblitzen) / none |
Ausgabe (outputs/ThemeName/)
- Beat-Sync-Film (
*.mp4) - Bericht: Anzahl der Beat-Segmente, Gesamtlänge, erkanntes BPM, Effekt
Ausführungsschritte
Skriptpfad (relativ zum Projektstamm): skills/shared/scripts/beatsync.py (build -h / beats -h).
1. (Optional) Schläge zuerst ansehen
python skills/shared/scripts/beatsync.py beats --music <Musik>
# Gibt Tempo (BPM) und Schlagzeitpunkte aus, um zu entscheiden, welcher --every-Wert sinnvoll ist
2. Beat-Sync-Video generieren
python skills/shared/scripts/beatsync.py build \
-i 1.jpg 2.jpg 3.jpg 4.jpg --music <Musik> \
-o outputs/ThemeName/show.mp4 \
--size 1080x1920 --every 2 --effect zoom
- Material = Bilder oder kurze Clips, kann weniger als die Anzahl der Beat-Segmente sein (automatische Wiederverwendung in einer Schleife).
--every 1: Bei jedem Schlag wechseln (Schnellschnitt, benötigt mehr Material);--every 4: Bei jedem Takt wechseln (ruhiger).--effect flash: Weißes Aufblitzen zu Beginn eines Segments für mehr Energie;--effect none: Sauberer, harter Schnitt.--max-duration 15: Begrenze die Filmlänge (z. B. für ein 15-Sekunden-TikTok).- Auch
--images-dir <Verzeichnis>möglich, um Material stapelweise einzufügen (nach Dateinamen sortiert).
Profil-Erkennung
- Mit Profil:
platforms.mddient nur zur Seitenverhältnis-Empfehlung, Bestätigung des Benutzers erforderlich; Beat-Stil (schnell/ruhig) und Effekt passen zur Konto-Ästhetik (Trend-/Sportkonten neigen zu schnellem flash, Lifestyle-/Heilungskonten neigen zu ruhigem zoom). - Ohne Profil: Zuerst Quer-/Hochformat klären; Standard: alle 2 Schläge, zoom-Effekt.
Regeln
- Je klarer der Musikrhythmus, desto präziser die Beat-Erkennung; bei fehlendem deutlichem Takt fällt das Skript automatisch auf gleichmäßige Intervalle zurück und vermerkt dies im Bericht.
- Beat-Schnitte sind harte Schnitte (keine Überblendungen), sonst geht der Beat-Effekt verloren – das ist beabsichtigt.
- Bei zu wenig Material wird automatisch wiederholt; bei ausreichend Material wird
--every 1~2empfohlen, damit jedes Segment ein neues Bild erhält. - Die Filmlänge entspricht standardmäßig der Musiklänge; mit
--max-durationauf Plattform-Länge begrenzen. - Ausgabe immer in
outputs/ThemeName/.
Referenz
Die Beat-Erkennung verwendet librosas beat_track (Onset-Stärke + dynamische Programmierung zum Finden von Schlägen); das harte Schneiden von Bildern auf Schläge ist die Standardmethode für Beat-Mashups. Die Verarbeitung von Schlag → Intervall → segmentweises Rendern → Audio-Video-Synchronisation wird in ein deterministisches Skript gekapselt, um manuelles Zählen und Nicht-Ausrichten zu vermeiden.