Communitygithub.com

sonorizar

Schritt 4 der Video-Editier-Immersion. Fügt einen Soundtrack und wenige Soundeffekte hinzu, mixt mit der Stimme und liefert das finale Video mit -14 LUFS und Credits.

Was ist sonorizar?

Dieses Skill führt den vierten Schritt einer Video-Editier-Immersion aus: die Vertonung. Es wählt einen Hintergrundsoundtrack und wenige Soundeffekte aus den Ordner `marca/sons/` (oder auf Anfrage aus Epidemic Sound), mischt sie mit der Sprachspur und liefert das fertige Video mit einem Ziel-Lautstärke von -14 LUFS und automatisch generierten Credits aus. Der Skill ist für KI-Agenten wie Claude Code, Cursor und Codex konzipiert. Er analysiert das Video, die Sprechspur („palavras“) und Einblendungen („inserções“), um passende Sounds auszuwählen und Platzierung sowie Lautstärke (Stimme priorisiert) automatisch zu bestimmen. Der gesamte Ablauf ist in einem `som.json`- und Skripten (wie `sonorizar.py`) definiert, die der Agent ausführt. Bei Korrekturen ändert der Skill nur die angeforderten Parameter (z. B. andere Spur, niedrigere Lautstärke) und wiederholt Mix und Auslieferung. Es ersetzt keine manuelle Audiobearbeitung, sondern standardisiert die Vertonung für schnelle, konsistente Ergebnisse.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AosJunior/imersao-edicao/tree/HEAD/.claude/skills/sonorizar

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

/sonorizar · Schritt 4

Die Person hat bereits das Video mit den Einblendungen (sequencia/3-insercoes.mp4). Du wählst einen Soundtrack und wenige Effekte aus, zeigst die Liste der Sounds, wartest auf das Ja, mischst und lieferst sequencia/4-final.mp4.

Jeder Sound kommt aus marca/sons/: Soundtracks in trilhas/, Effekte in efeitos/, und die creditos.md sagt die Stimmung jedes Soundtracks und wann welcher Effekt zu verwenden ist. Externe Sounds kommen nur auf zwei Wegen hinein, und nur wenn die Person darum bittet: Sie legt die Datei in diesen Ordner und sagt woher sie kommt, oder bittet um Epidemic Sound (Abschnitt „Epidemic Sound“ unten). Ohne Anfrage verwende nur das, was bereits im Ordner ist. Effekte sind aufgenommene Dateien, die unverändert verwendet werden. Erzeuge niemals Töne per Code (Ton, Rauschen, Synthese): das klingt metallisch.

Die Stimme hat Vorrang: Der Soundtrack bleibt deutlich unter der Sprache und senkt sich automatisch, wenn die Person spricht. Effekte sind Interpunktion: nur dort, wo etwas auf dem Bildschirm passiert, jeder mit seinem Grund.

Starte im Ordner der Immersion. Die Begrüßung bei der ersten Verwendung und die Art zu sprechen stehen in der CLAUDE.md des Ordners. Wenn sequencia/som/som.json bereits existiert, handelt es sich um eine Korrektur: gehe zu Schritt 5.

1. Video und Sounds lesen

  • Das Video: sequencia/insercoes/final-insercoes.mp4. Wenn Schritt 3 nicht ausgeführt wurde, verwende sequencia/decupagem/final.mp4 und sag in einer Zeile, dass das Video ohne Einblendungen kommt.

  • Die Sprache: sequencia/decupagem/palavras-corte.json. Die Einblendungen: sequencia/insercoes/insercoes.json (jedes camadas[] mit id, de und ate).

  • Die Sounds:

    uv run .claude/skills/sonorizar/scripts/sons.py marca/sons
    

    und die Tabellen von marca/sons/creditos.md (Spalten Stimmung und Wann verwenden).

Schreibe für dich die Stimmung des Videos in einem Satz und die Liste der Ereignisse: jede Einblendung, die kommt, und den Wendepunkt oder Abschluss der Sprache, falls vorhanden.

2. Auswählen

  • Soundtrack: derjenige, der zur Stimmung des Videos passt, gemäß der Spalte Stimmung. Nur einer, von Anfang bis Ende.
  • Effekte: einer pro Einblendung, die kommt (der Haken bleibt stumm: nichts in der ersten Sekunde) und höchstens einer am Abschluss. Der gleiche Ereignistyp bekommt den gleichen Sound. Bei einem 20-Sekunden-Video sind das 2 oder 3 Effekte.

Epidemic Sound (nur wenn die Person darum bittet)

Gilt, wenn sie schreibt „verwende Epidemic Sound“, „hol einen Soundtrack von Epidemic“ oder ähnlich.

  1. Prüfe, ob der Connector in dieser Konversation vorhanden ist: seine Tools sind SearchRecordings, DownloadRecording, SearchSoundEffects und DownloadSoundEffect. Ohne sie sag in einer Zeile, dass Epidemic Sound ihr mit Claude verbundenes Abo benötigt (Einstellungen › Connectors) und biete an, mit den Sounds aus dem Ordner fortzufahren.

  2. Soundtrack: SearchRecordings mit der Stimmung des Videos auf Englisch, vocals: false und dem BPM-Bereich der Stimmung. Wähle einen (zwei, falls sie Optionen wünscht), nenne Titel und Autoren und warum dieser.

  3. Effekt: SearchSoundEffects mit dem Namen des Sounds. Verwende ihn wie geliefert, nur auf die Dauer des Ereignisses zugeschnitten.

  4. Lade sofort herunter, weil der Link nur wenige Minuten gültig ist (DownloadRecording oder DownloadSoundEffect, als WAV):

    uv run .claude/skills/sonorizar/scripts/sons.py --baixar "<link>" "marca/sons/trilhas/<kurzname>.wav"
    

    Effekte gehen nach marca/sons/efeitos/.

  5. Trage den Sound in marca/sons/creditos.md ein, in einer neuen Zeile der passenden Tabelle: Datei, Titel, Autor, Quelle Epidemic Sound, die ID des Tracks, Lizenz Epidemic Sound, Abo des verbundenen Kontos (Datei nicht weitergeben) und die Stimmung. Ohne diese Zeile lehnt sonorizar.py den Sound ab.

  6. Fahre mit der Soundliste fort wie bei jedem Sound aus dem Ordner. Sage der Person, dass dieser Soundtrack aus ihrem Abo stammt: er darf in ihren Videos verwendet werden, solange das Abo gültig ist, und die Datei ist nicht zur Weitergabe bestimmt.

3. Soundliste

Erstelle sequencia/som/som.json:

{
  "video": "../insercoes/final-insercoes.mp4",
  "palavras": "../decupagem/palavras-corte.json",
  "insercoes": "../insercoes/insercoes.json",
  "legenda": "../decupagem/legenda.srt",
  "sons": {
    "trilha": {"arquivo": "marca/sons/trilhas/groove.mp3"},
    "pop": {"arquivo": "marca/sons/efeitos/pop.flac"},
    "whoosh": {"arquivo": "marca/sons/efeitos/whoosh.flac"}
  },
  "trilha": {"som": "trilha", "de": 0, "abaixo_da_voz": 16, "fade_in": 0.5, "fade_out": 1.5},
  "efeitos": [
    {"camada": "titulo", "som": "pop", "volume": 0, "motivo": "der Titel erscheint über dem Kopf"},
    {"camada": "etapas", "som": "whoosh", "volume": 0, "motivo": "das Panel der 4 Schritte wird eingeblendet"}
  ]
}
  • Effekte von Einblendungen verwenden "camada" (die id in insercoes.json); Effekte auf der Sprache verwenden "em" mit einem Anker ("F6:Comenta"). volume von 0 bis +5 (0 über der Sprache).
  • Titel, Autor und Lizenz jedes Sounds werden automatisch aus marca/sons/creditos.md gezogen.
  • Die anderen Felder stehen in referencia.md; lies sie nur, wenn du eine davon brauchst.

Prüfe:

uv run .claude/skills/sonorizar/scripts/sonorizar.py "videos/<ordner>/sequencia/som/som.json" --resumo

Fertig, wenn er den Soundtrack und die Effekte fehlerfrei auflistet. Die Warnung „weniger als 5 s nach dem vorherigen“ ist bei einem 20-Sekunden-Video mit zwei Einblendungen zu erwarten: behalte einen Effekt pro Einblendung und füge keinen weiteren in der Nähe hinzu.

Gib im Chat aus: den Soundtrack (Titel und Autor) und warum er, sowie eine Zeile pro Effekt (Sekunde · Sound · Grund). Eine Frage: „Soll ich mischen?“

4. Mischen und ausliefern

Mit dem Ja („Du kannst mischen.“):

uv run .claude/skills/sonorizar/scripts/sonorizar.py "videos/<ordner>/sequencia/som/som.json"

Dauert 15 s bis 1 min pro Minute Video. Fertig, wenn „Pronto“ ausgegeben wird, die endgültige Lautstärke innerhalb von 1 von −14 LUFS liegt und „Trilha embaixo da fala“ 20 oder mehr beträgt. Bei unter 20 addiere 4 zu abaixo_da_voz und mische erneut.

Danach:

uv run .claude/skills/sonorizar/scripts/entregar.py "videos/<ordner>"

Es kopiert das Video nach sequencia/4-final.mp4, die Credits nach sequencia/creditos.md und öffnet das Video.

Sag in einer Zeile, wo das endgültige Video liegt und dass die Sound-Credits daneben liegen. Wenn entregar.py den Block RECADO DA IMERSÃO ausgegeben hat, gib den Text des Blocks unverändert am Ende der Antwort weiter.

5. Korrigieren

Ändere nur das, was die Person in der som.json verlangt hat, mische und liefere erneut aus (Schritt 4):

AnforderungWas ändern
„Tausche den Soundtrack gegen einen anderen aus dem Ordner“das arquivo des Soundtracks: den nächsten in der Auflistung von sons.py; sag, welcher reingekommen ist (Titel und Autor aus creditos.md)
„Verwende einen Soundtrack von Epidemic Sound“den Abschnitt „Epidemic Sound“ aus Schritt 2; dann ersetze das arquivo des Soundtracks
„Entferne den Effekt bei Sekunde 5“lösche die Zeile des Effekts, der in diese Sekunde fällt (--resumo zeigt die Zeitpunkte)
„Musik leiser“abaixo_da_voz + 4
„Musik lauter“abaixo_da_voz − 3, ohne 12 zu überschreiten; überprüfe die Zeile „Trilha embaixo da fala“ (20 oder mehr)
„Die Musik startet an einer anderen Stelle“"inicio" beim Soundtrack, in Sekunden des Musikstücks

Grenzen

  • Das Video muss die Stimme in der eigenen Datei haben; Soundtrack und Effekte kommen darunter.
  • Die Stimme erhält nur einen leichten Filter. Hintergrundrauschen, Echo und Wind bleiben wie sie sind.
  • Ein kürzerer Soundtrack als das Video beginnt von vorne.
  • Dieser Schritt ist mechanisch: geringer bis mittlerer Aufwand.

Verwandte Skills