Was macht beatcut?
beatcut erstellt aus einem Ordner mit Videoclips und einer Musikdatei ein Video, dessen Schnitte frame-genau auf den Beats liegen. Der Zustand wird in zwei Dateien im Projektordner gespeichert: project.json (Einstellungen) und shots.json (der Schnitt). Das Kommandozeilenwerkzeug heißt beatcut.py.
Pfade
Führen Sie die Befehle mit dem Python aus, das die erforderlichen Pakete installiert hat (pip install -r requirements.txt; ffmpeg und ffprobe müssen sich im PATH befinden). Verwenden Sie den Ordner, in dem dieses Skill installiert ist, als Repository-Ordner:
python <skill-Ordner>/beatcut.py <Befehl> ...
Im Folgenden steht beatcut.py für den vollständigen Pfad. Pfade zu Clips und Projekten können überall liegen; setzen Sie sie in Anführungszeichen, wenn sie Leerzeichen enthalten. Ein Projekt ist immer <Clips-Ordner>/beatcut; jeder Befehl außer init und sheet erwartet diesen Projektordner.
Arbeitsablauf
- Fragen, was fehlt: Den Ordner mit den Clips, die Musikdatei und die Ausgabeabmessungen (Standard: 1920x1080 für Draft, 3840x2160 für Final; vertikale Maße wie 1080x1920 sind in Ordnung).
- Initialisieren:
beatcut.py init <Clips-Ordner> --music <Musikdatei>. Es gibterstellt: <Ordner>aus und kopiert die Musik in das Projekt. Wenn esproject.json existiert bereitsmeldet, existiert das Projekt; verwenden Sie es und initialisieren Sie nicht neu. Bearbeiten Sieproject.json, wenn Größen,fill,fps,encoder,exclude_prefixoder benutzerdefinierteprofilesgeändert werden müssen (siehe Regeln unten). - Beats:
beatcut.py beats <Projekt>. Es gibtperiod,t0undbpmaus und schreibt sie inshots.json. Die Erkennung geht von einem gleichmäßigen Tempo aus und kann beit0um einige Hundertstelsekunden abweichen. Wenn es mitweniger als 4 Beats erkanntbeendet wird (Exit 1), setzen Sieperiodundt0von Hand (period = 60 / BPM; t0 = Sekunde des ersten Beats). Teilen Sie dem Benutzer die Zahlen mit; er kann sie im Picker korrigieren. - Schnitte auswählen, auf zwei Arten:
- Picker (Standard). Starten Sie
beatcut.py pick <Projekt>im Hintergrund (es blockiert bis zum Stopp; es öffnet den Browser, es sei denn, Sie fügen--no-openhinzu; Standardport 8765, ändern mit--port N). Teilen Sie dem Benutzer die ausgegebene URL mit,http://127.0.0.1:<port>/, und dass die Seite automatisch speichert. Warten Sie, bis der Benutzer sagt, dass er fertig ist, stoppen Sie dann den Server (Strg+C oder Hintergrundprozess beenden) und lesen Sieshots.json. Bearbeiten Sieshots.jsonnicht, während der Picker geöffnet ist: Die Seite würde Ihre Änderungen überschreiben. - Von Hand, wenn der Benutzer Sie bittet, den Schnitt zu erstellen oder genaue Zeiten angibt. Befolgen Sie die Regeln unten und führen Sie dann
checkaus.
- Picker (Standard). Starten Sie
- Prüfen:
beatcut.py check <Projekt>. Exit 0 undok: <n> Schnitte, <s> sbedeutet keine Fehler; lesen Sie auch die Warnungen (stderr). Beheben Sie jeden Fehler vor dem Rendern. - Draft:
beatcut.py draft <Projekt>. Es gibtencoder: ...,Segment i/nund schließlich den Pfad vonout/<out_name>_draft.mp4aus. - Anschauen:
beatcut.py sheet <Video> --out <irgendein .jpg-Pfad>erstellt ein 5-mal-4-Kontaktblatt; öffnen Sie dieses Bild und beschreiben Sie dem Benutzer das Ergebnis (Reihenfolge der Schnitte, Farbe, Überblendungen, schwarze Frames, falsche Zuschnitte). Wählen Sie einen--out-Pfad außerhalb des Clips-Ordners, z. B. einen Scratch-Ordner. - Final, nur mit Zustimmung des Benutzers: Nachdem Sie den Draft gezeigt haben, fragen Sie, ob das Finale gerendert werden soll. Führen Sie
beatcut.py final <Projekt>nur nach einem eindeutigen Ja aus. Das Finale ist langsamer und größer. Melden Sie den Ausgabepfad.
Wenn der Benutzer den Schnitt danach ändert, gehen Sie zurück zu Schritt 4. Rendervorgänge verwenden zwischengespeicherte Segmente, sodass ein zweiter Draft schneller ist.
Bearbeiten von shots.json von Hand
Halten Sie die Datei als gültiges JSON (UTF-8). check meldet jeden Verstoß gegen diese Regeln.
Oberste Ebene:
version:1.period: Zahl, größer als 0,05 und kleiner als 10.t0: Zahl, 0 oder größer.tail: 0 bis 30 (Standard 1,5).shots: Liste, höchstens 2000.- Optional:
bad(Clipname zu Liste von{"a": s, "b": s, "note": ""}mitb > a >= 0),clipnotes(Clipname zu Text),markers({"beat": int >= 0, "title": Text}; nur im Picker angezeigt). Behalten Sie Schlüssel, die Sie nicht kennen; die Werkzeuge bewahren sie.
Jeder Schnitt:
clip: Dateiname mit Erweiterung, wie er im Clips-Ordner erscheint. Kein/oder\, kein:. Muss eine Datei direkt inclips_dirsein und mitextensionsübereinstimmen.in(0 oder mehr) undout(größer alsin): Sekunden im Quellclip.beats: Ganzzahl von 1 bis 512.- Optional, mit Standardwerten:
fit(fitodercut; Standardfit),interp(oflow,blend,none; lassen Sie es für automatische Entscheidung weg),prof(ein eingebauter Nameneutral,warm,cool,contrast,goldenoder ein inproject.jsonunterprofilesdefinierter Name; Standardneutral),tin(cut,fade,fadewhite; Standardcut),tdur(0 bis 5 Sekunden, Standard 0,5),note(Text, höchstens 2000 Zeichen).
Wie die Zahlen verwendet werden:
- Schnitte werden nacheinander abgespielt; Schnitt N belegt
beatsBeats im Raster beginnend beit0 + period * (Summe der vorherigen Beats). Der erste Schnitt beginnt bei Videoframe 0 an seinemin-Punkt, deckt also auch die Zeit vor dem ersten Beat ab und liest über seinouthinaus. fit: Geschwindigkeit =(out - in) / (beats * period). Eine Geschwindigkeit innerhalb von 0,015 von 1 gilt als 1.checklehnt Geschwindigkeiten außerhalb von 0,1x bis 8x ab. Um einen Schnitt bei normaler Geschwindigkeit mitfitzu halten, setzen Sieout = in + beats * period.cut: Spielt mit 1x ab;outwird nicht für die Geschwindigkeit verwendet (der Picker schreibtout = in + beats * period). Machen Sie dasselbe.- Der letzte Schnitt wird um
tailSekunden verlängert, und das Bild blendet übertailaus. Der gesamte Schnitt darf nicht länger als die Musik sein. - Jeder Schnitt benötigt Quellmaterial bis zu seinem Ende (einschließlich
tailund Vorlauf des ersten Schnitts) mit 0,1 s Spielraum vor dem Ende des Clips. Einfade- oderfadewhite-Übergang leiht sich die Hälfte seiner Länge von jedem Nachbarn, sodass der frühere Schnitt Quellmaterial über seinouthinaus benötigt und der spätere Schnitt Quellmaterial vor seineminbenötigt. - Ein Übergang muss kürzer sein als die Schnitte um ihn herum.
tdurwird auf eine gerade Anzahl von Frames gerundet; unter 2 Frames bedeutet einen reinen Schnitt (Cut). - Zeitlupe: Automatische Interpolation erfolgt nur, wenn der Schnitt langsamer als 0,97x läuft und die Quellbildrate mal der Geschwindigkeit unter der Ausgabebildrate liegt (
blendbei Drafts,oflowbei Finals). Setzen Sieinterpnur, wenn der Benutzer darum bittet. - Wählen Sie
in/outso, dass der Bereich keinenbad-Bereich überlappt;checkwarnt, wenn doch.
project.json-Regeln (wenn Sie sie ändern):
- Unbekannte Schlüssel sind ein Fehler.
musicist relativ zum Projektordner, kein.., kein absoluter Pfad.draftundfinalsind{"width": n, "height": n}mit positiven geraden ganzen Zahlen.fpsist ein String wie"25"oder"30000/1001".fill:coveroderblur.encoder:auto,cpuodernvenc.loudness: -40 bis -5. profiles: Name ([a-z0-9_-], 1 bis 32 Zeichen) zu einer ffmpeg-Filterkette, ohne;,[oder]. Schnitte verweisen nur über den Namen auf Profile.
Meldungen und was zu tun ist
Warnungen beginnen mit warning: und stoppen einen Rendervorgang nicht. Fehler beginnen mit error: und gehen nach stderr.
| Meldung | Bedeutung und Aktion |
|---|---|
ffmpeg was not found on PATH; install FFmpeg and try again (Exit 2) | ffmpeg oder ffprobe ist nicht im PATH. Bitten Sie den Benutzer, FFmpeg zu installieren; installieren Sie es nicht selbst, es sei denn, der Benutzer bittet darum. |
no project.json in <folder> (did you mean <folder>\beatcut?) (Exit 1) | Sie haben den Clips-Ordner übergeben. Verwenden Sie den Ordner beatcut darin. |
unknown key(s): ..., <field>: muss ... sein | Ein Feld in project.json ist ungültig. Korrigieren Sie dieses Feld. |
<path>: invalid JSON (...) (<path> ist der vollständige Pfad von shots.json) | Syntaxfehler in der Datei. Beheben Sie ihn; die vorherige Version befindet sich möglicherweise in shots.json.bak. |
shots[i].<field>: muss ... sein | Ein Schnitt verstößt gegen die obigen Regeln (i zählt ab 0). Korrigieren Sie ihn. |
no shots | shots ist leer. Fügen Sie Schnitte hinzu (Picker oder von Hand). |
shot N (clip): clip not found in the clips folder | Der Dateiname ist falsch oder die Datei fehlt oder wird durch extensions oder exclude_prefix ausgeschlossen. Überprüfen Sie die Schreibweise; erstellen oder kopieren Sie niemals Dateien in den Clips-Ordner, um dies zu beheben. |
shot N (clip): needs source up to X s but the clip is Y s long | Der Bereich plus Vorlauf, Tail oder Übergang reicht über den Clip hinaus. Verschieben Sie in nach vorne, verwenden Sie weniger Beats, verwenden Sie fit mit einem kürzeren out oder verkürzen Sie den Übergang. |
shot N (clip): needs X s before the start of the clip; move in later | Ein Vorlauf des ersten Schnitts oder ein Übergang erreicht den Punkt vor 0. Erhöhen Sie in oder verkürzen Sie den Übergang. |
shot N (clip): shorter than its transitions; ... | Übergang länger als der Schnitt. Verringern Sie tdur oder fügen Sie Beats hinzu. |
shot N (clip): speed X is outside 0.1x-8.0x | Bereich und Beat-Anzahl passen nicht. Ändern Sie beats oder den Bereich. |
the edit is X s long but the music is only Y s | Entfernen Sie Beats oder Schnitte, verringern Sie tail oder verwenden Sie eine längere Musikdatei. |
warning: shot N (clip): uses a range marked bad (...) | Der Schnitt überlappt einen bad-Bereich. Verschieben Sie ihn oder informieren Sie den Benutzer. |
warning: <clip>: HDR source (...); colours will look washed out ... | HDR-Clip; beatcut führt kein Tone-Mapping durch. Informieren Sie den Benutzer; schlagen Sie SDR-Clips vor. |
warning: <clip>: cannot be read (...) | ffprobe kann den Clip nicht lesen. Informieren Sie den Benutzer. |
music file not found: <name> | Die music-Datei fehlt im Projektordner. |
profile <name>: ffmpeg rejects the filter chain | Ein benutzerdefiniertes Profil ist falsch. Korrigieren Sie seine Filterkette in project.json. |
too many shots to assemble in one pass (N); split the edit | Der Schnitt ist zu lang für einen Render-Durchgang. Informieren Sie den Benutzer; teilen Sie ihn in mehrere Projekte oder weniger Schnitte auf. |
another render is already running for this project (Exit 2) | Ein Rendervorgang (möglicherweise vom Picker gestartet) läuft bereits. Warten Sie; löschen Sie nicht work/. |
cannot write <file>; close it in any player and try again | Die Ausgabe ist anderswo geöffnet. Bitten Sie den Benutzer, sie zu schließen. |
fewer than 4 beats were detected; set period and t0 by hand (Exit 1) | Siehe Schritt 3. |
Exit-Codes: 0 Erfolg, 1 ein Problem mit der Benutzereingabe (beheben und erneut ausführen), 2 Umgebungs- oder Laufzeitfehler.
Nicht tun
- Ändern, verschieben, umbenennen oder löschen Sie nicht die Quellclips, und schreiben Sie nichts in den Clips-Ordner außer dem von
initerstelltenbeatcut-Projektordner. Alles, was das Werkzeug schreibt, befindet sich im Projektordner. - Löschen Sie nicht
project.json,shots.jsonoder die Musikdatei. Führen Sieinitnicht erneut über ein bestehendes Projekt aus. - Führen Sie
finalnicht ohne Zustimmung des Benutzers aus, nachdem dieser den Draft gesehen hat. - Setzen Sie den Picker keinem Netzwerk aus: keine Portweiterleitung, Tunnel, Reverse-Proxies, und versuchen Sie nicht, ihn an eine andere Adresse zu binden. Er hört nur auf
127.0.0.1und ist nicht vor anderen Programmen auf demselben Computer geschützt. - Fügen Sie keine Filterketten in
shots.jsonein, und bearbeiten Sieshots.jsonnicht, während der Picker läuft. - Behaupten Sie nicht, dass das Ergebnis gut ist, ohne den Draft (Kontaktblatt oder das Video selbst) anzusehen.
- Versprechen Sie keine Funktionen, die das Werkzeug nicht hat: kein HDR-Tone-Mapping, keine Gesichtserkennung, kein CapCut-Export, keine Soundeffekte. Linux und macOS sind nicht getestet; Windows ist die getestete Plattform.