Communitygithub.com

sonorizar

Ajoute une bande sonore et quelques effets sonores à votre vidéo, mixe la voix au premier plan et livre le fichier final en -14 LUFS avec les crédits.

Qu'est-ce que sonorizar ?

Sonorizar est le quatrième et dernier pas d'un flux éditorial vidéo immersif, à exécuter lorsqu'un utilisateur demande /sonorizer, de la musique, des effets sonores ou une correction de mix. La compétence choisit une piste musicale et quelques effets sonores depuis le dossier `marca/sons/` (ou depuis Epidemic Sound si l'utilisateur le demande et que le connecteur est présent), ajuste le volume de la piste pour qu'elle reste nettement en dessous de la voix, insère des effets ponctuels synchronisés avec les insertions visuelles, mixe le tout avec la voix au premier plan, et produit un fichier final à -14 LUFS avec les crédits. Le travail est exécuté via des scripts Python locaux (`sonorizer.py`, `entregar.py`), avec une vérification préalable via `--resume`. Le système est conçu pour être simple et rapide : il ne génère jamais de son par code (synthèse ou bruit), se limite à un effet par événement, et permet des corrections ciblées comme le changement de piste, le réglage du volume ou la suppression d'un effet. Supporté par les outils de ligne de commande et adapté à tout type de vidéo où la voix est déjà encodée dans le fichier.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/sonorizar · étape 4

La personne a déjà la vidéo avec les insertions (sequencia/3-insercoes.mp4). Vous choisissez une piste musicale et quelques effets, affichez la liste des sons, attendez le oui, mixez et livrez sequencia/4-final.mp4.

Tout son provient de marca/sons/ : pistes dans trilhas/, effets dans efeitos/, et le fichier creditos.md décrit l'ambiance de chaque piste et quand utiliser chaque effet. Les sons extérieurs n'entrent que de deux façons, et seulement si la personne le demande : elle place le fichier dans ce dossier en précisant sa provenance, ou elle demande Epidemic Sound (section "Epidemic Sound", ci-dessous). Sans demande, utilisez uniquement ce qui se trouve déjà dans le dossier. Un effet est un fichier enregistré, utilisé tel quel. Ne générez jamais de son par code (ton, bruit, synthèse) : le résultat serait métallique.

La voix commande : la piste reste nettement en dessous de la parole et baisse automatiquement quand la personne parle. L'effet est une ponctuation : uniquement là où quelque chose se passe à l'écran, chacun avec sa raison.

Exécutez à partir du dossier de l'immersion. Le message de bienvenue pour la première utilisation et la manière de parler se trouvent dans le CLAUDE.md du dossier. Si sequencia/som/som.json existe déjà, c'est une correction : passez à l'étape 5.

1. Lire la vidéo et les sons

  • La vidéo : sequencia/insercoes/final-insercoes.mp4. Si l'étape 3 n'a pas été exécutée, utilisez sequencia/decupagem/final.mp4 et dites en une ligne que la vidéo sera sans insertions.

  • La parole : sequencia/decupagem/palavras-corte.json. Les pièces : sequencia/insercoes/insercoes.json (chaque camadas[] avec id, de et ate).

  • Les sons :

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

    et les tableaux de marca/sons/creditos.md (colonnes Climat et Quand utiliser).

Écrivez pour vous le climat de la vidéo en une phrase et la liste des événements : chaque pièce qui entre, et le tournant ou la conclusion de la parole, s'il y en a.

2. Choisir

  • Piste : celle qui correspond au climat de la vidéo, d'après la colonne Climat. Une seule, du début à la fin.
  • Effets : un par pièce qui entre (l'accroche reste muette : rien dans la première seconde) et, au maximum, un pour la conclusion. Le même type d'événement reçoit le même son. Dans une vidéo de 20 s, cela donne 2 ou 3 effets.

Epidemic Sound (uniquement sur demande)

Utilisable lorsque la personne écrit "utilise Epidemic Sound", "prends une piste d'Epidemic" ou une expression similaire.

  1. Vérifiez si le connecteur est présent dans cette conversation : ses outils sont SearchRecordings, DownloadRecording, SearchSoundEffects et DownloadSoundEffect. Sans eux, dites en une ligne qu'Epidemic Sound nécessite que son abonnement soit connecté à Claude (Paramètres › Connecteurs) et proposez de continuer avec les sons du dossier.

  2. Piste : SearchRecordings avec le climat de la vidéo en anglais, vocals: false et la plage de bpm du climat. Choisissez-en une (deux si elle a demandé des options), indiquez le titre et l'auteur et pourquoi celle-ci.

  3. Effet : SearchSoundEffects par le nom du son. Utilisez-le tel quel, seulement coupé à la durée de l'événement.

  4. Téléchargez immédiatement, car le lien ne vaut que quelques minutes (DownloadRecording ou DownloadSoundEffect, en WAV) :

    uv run .claude/skills/sonorizar/scripts/sons.py --baixar "<lien>" "marca/sons/trilhas/<nom-court>.wav"
    

    L'effet va dans marca/sons/efeitos/.

  5. Notez le son dans marca/sons/creditos.md, sur une nouvelle ligne du tableau approprié : fichier, titre, auteur, Source Epidemic Sound, l'ID de la piste, Licence Epidemic Sound, abonnement du compte connecté (ne pas redistribuer le fichier) et le climat. Sans cette ligne, sonorizar.py refuse le son.

  6. Passez à la liste des sons comme pour tout son du dossier. Dites à la personne que cette piste provient de son abonnement : elle peut l'utiliser dans ses vidéos tant que l'abonnement est actif, et le fichier n'est pas à redistribuer.

3. Liste des sons

Enregistrez 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": "le titre apparaît au-dessus de la tête"},
    {"camada": "etapas", "som": "whoosh", "volume": 0, "motivo": "le panneau des 4 étapes entre"}
  ]
}
  • Effet de pièce avec "camada" (l'id dans insercoes.json) ; effet sur la parole avec "em" sur une ancre ("F6:Comenta"). volume de 0 à +5 (0 au-dessus de la parole).
  • Le titre, l'auteur et la licence de chaque son sont extraits automatiquement de marca/sons/creditos.md.
  • Les autres champs sont décrits dans referencia.md ; ne le consultez que si nécessaire.

Vérifiez :

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

Prêt lorsqu'il liste la piste et les effets sans erreur. L'avertissement "moins de 5 s après le précédent" est normal dans une vidéo de 20 s avec deux insertions : conservez un effet par pièce et n'en ajoutez pas d'autre à proximité.

Envoyez dans le chat : la piste (titre et auteur) et pourquoi celle-ci, et une ligne par effet (seconde · son · motif). Une question : "Puis-je mixer ?"

4. Mixer et livrer

Avec le oui ("Tu peux mixer.") :

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

Cela prend de 15 s à 1 min par minute de vidéo. Prêt lorsqu'il affiche "Prêt", que le volume final est à moins de 1 de −14 LUFS et que "Piste sous la parole" donne 20 ou plus. En dessous de 20, ajoutez 4 à abaixo_da_voz et mixez à nouveau.

Ensuite :

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

Il copie la vidéo vers sequencia/4-final.mp4, les crédits vers sequencia/creditos.md et ouvre la vidéo.

Dites en une ligne où se trouve la vidéo finale et que les crédits des sons sont à côté. Si entregar.py a affiché le bloc RECADO DA IMERSÃO, retransmettez le texte du bloc tel quel, à la fin de la réponse.

5. Corriger

Modifiez uniquement ce que la personne a demandé dans som.json, mixez et livrez à nouveau (étape 4) :

DemandeCe qu'il faut changer
"Change la piste pour une autre du dossier"le arquivo de la piste : la suivante dans la liste de sons.py ; dites laquelle est entrée (titre et auteur, d'après creditos.md)
"Utilise une piste d'Epidemic Sound"la section "Epidemic Sound" de l'étape 2 ; puis changez le arquivo de la piste
"Enlève l'effet de la seconde 5"supprimez la ligne de l'effet qui tombe à cette seconde (le --resumo affiche les temps)
"Musique plus basse"abaixo_da_voz + 4
"Musique plus forte"abaixo_da_voz − 3, sans dépasser 12 ; vérifiez la ligne "Piste sous la parole" (20 ou plus)
"La musique commence à un autre endroit""inicio" dans la piste, en secondes de la musique

Limites

  • La vidéo doit avoir la voix dans le fichier lui-même ; la piste et les effets sont ajoutés en dessous.
  • La voix ne reçoit qu'un filtre léger. Le bruit de fond, l'écho et le vent restent tels quels.
  • Une piste plus courte que la vidéo reprend depuis le début.
  • Cette étape est mécanique : effort faible ou moyen.

Skills associés