sonorizar

/sonorizar · paso 4

La persona ya tiene el video con las inserciones (sequencia/3-insercoes.mp4). Tú eliges una pista musical y pocos efectos, muestras la lista de sonidos, esperas el sí, mezclas y entregas sequencia/4-final.mp4.

Todo sonido sale de marca/sons/: pistas en trilhas/, efectos en efeitos/, y el creditos.md indica el clima de cada pista y cuándo usar cada efecto. El sonido externo entra de dos maneras, y solo cuando la persona lo pide: ella coloca el archivo en esa carpeta y dice de dónde vino, o pide Epidemic Sound (sección "Epidemic Sound", abajo). Sin solicitud, usa solo lo que ya está en la carpeta. El efecto es un archivo grabado, usado tal cual. Nunca generes sonido por código (tono, ruido, síntesis): suena metálico.

La voz manda: la pista queda muy por debajo del habla y baja sola cuando la persona habla. El efecto es puntuación: solo donde algo ocurre en la pantalla, cada uno con su motivo.

Ejecuta desde la carpeta de la inmersión. El saludo del primer uso y la forma de hablar están en el CLAUDE.md de la carpeta. Si sequencia/som/som.json ya existe, es una corrección: ve al paso 5.

1. Leer el video y los sonidos

• El video: sequencia/insercoes/final-insercoes.mp4. Si el paso 3 no se ejecutó, usa sequencia/decupagem/final.mp4 y di en una línea que el video va sin inserciones.

• El habla: sequencia/decupagem/palavras-corte.json. Las piezas: sequencia/insercoes/insercoes.json (cada camadas[] con id, de y ate).

• Los sonidos:

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

  y las tablas de marca/sons/creditos.md (columnas Clima y Cuándo usar).

Escribe para ti el clima del video en una frase y la lista de eventos: cada pieza que entra, y el giro o el cierre del habla, si lo hay.

2. Elegir

• Pista: la que combina con el clima del video, según la columna Clima. Una sola, de principio a fin.
• Efectos: uno por pieza que entra (el gancho queda mudo: nada en el primer segundo) y, como máximo, uno en el cierre. El mismo tipo de evento lleva el mismo sonido. En un video de 20 s esto da 2 o 3 efectos.

Epidemic Sound (solo cuando la persona lo pide)

Vale cuando ella escribe "usa el Epidemic Sound", "toma una pista del Epidemic" o similar.

1. Verifica si el conector está en esta conversación: sus herramientas son SearchRecordings, DownloadRecording, SearchSoundEffects y DownloadSoundEffect. Sin ellas, di en una línea que Epidemic Sound necesita su suscripción conectada a Claude (Configuración › Conectores) y ofrece continuar con los sonidos de la carpeta.

2. Pista: SearchRecordings con el clima del video en inglés, vocals: false y el rango de bpm del clima. Elige una (dos, si ella pidió opciones), di título y autor y por qué esa.

3. Efecto: SearchSoundEffects por el nombre del sonido. Úsalo tal como vino, solo cortado al tamaño del evento.

4. Descárgalo en el momento, porque el enlace dura pocos minutos (DownloadRecording o DownloadSoundEffect, en WAV):

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

   El efecto va a marca/sons/efeitos/.

5. Anota el sonido en marca/sons/creditos.md, en una línea nueva de la tabla correcta: archivo, título, autor, Fuente Epidemic Sound, el ID de la pista, Licencia Epidemic Sound, suscripción de la cuenta conectada (no redistribuir el archivo) y el clima. Sin esa línea, sonorizar.py rechaza el sonido.

6. Continúa con la lista de sonidos como con cualquier sonido de la carpeta. Dile a la persona que esta pista es de su suscripción: sirve en sus videos mientras la suscripción esté activa, y el archivo no debe redistribuirse.

3. Lista de sonidos

Graba 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": "el título aparece sobre la cabeza"},
    {"camada": "etapas", "som": "whoosh", "volume": 0, "motivo": "el panel de las 4 etapas entra"}
  ]
}

• El efecto de pieza va con "camada" (el id en insercoes.json); el efecto en el habla, con "em" en un ancla ("F6:Comenta"). volume de 0 a +5 (0 sobre el habla).
• El título, autor y licencia de cada sonido se obtienen solos del marca/sons/creditos.md.
• Los otros campos están en referencia.md; léelo solo si necesitas uno.

Verifica:

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

Listo cuando muestra la pista y los efectos sin error. La advertencia "menos de 5 s después del anterior" es esperada en un video de 20 s con dos inserciones: mantén un efecto por pieza y no agregues otro cerca.

Envía en el chat: la pista (título y autor) y por qué esa, y una línea por efecto (segundo · sonido · motivo). Una pregunta: "¿Puedo mezclar?"

4. Mezclar y entregar

Con el sí ("Puedes mezclar."):

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

Tarda de 15 s a 1 min por minuto de video. Listo cuando imprime "Pronto", el volumen final está a menos de 1 de −14 LUFS y "Trilha embaixo da fala" da 20 o más. Por debajo de 20, suma 4 al abaixo_da_voz y mezcla de nuevo.

Después:

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

Copia el video a sequencia/4-final.mp4, los créditos a sequencia/creditos.md y abre el video.

Di en una línea dónde está el video final y que los créditos de los sonidos están al lado. Si entregar.py imprimió el bloque RECADO DA IMERSÃO, transmite el texto del bloque tal cual, al final de la respuesta.

5. Corregir

Cambia solo lo que la persona pidió en som.json, mezcla y entrega de nuevo (paso 4):

Solicitud	Qué cambiar
"Cambia la pista por otra de la carpeta"	el arquivo de la pista: la siguiente en el listado de sons.py; di cuál entró (título y autor, del creditos.md)
"Usa una pista de Epidemic Sound"	la sección "Epidemic Sound" del paso 2; luego cambia el arquivo de la pista
"Quita el efecto del segundo 5"	borra la línea del efecto que cae en ese segundo (el --resumo muestra los tiempos)
"Música más baja"	abaixo_da_voz + 4
"Música más alta"	abaixo_da_voz − 3, sin pasar de 12; verifica la línea "Trilha embaixo da fala" (20 o más)
"La música comienza en otro punto"	"inicio" en la pista, en segundos de la música

Límites

• El video debe tener la voz en el propio archivo; la pista y los efectos entran por debajo de ella.
• La voz recibe solo un filtro ligero. El ruido de fondo, eco y viento se quedan como están.
• La pista más corta que el video se reinicia desde el principio.
• Esta etapa es mecánica: esfuerzo bajo o medio.