Communitygithub.com

sonorizar

Imersão de edição de vídeo, passo 4. Adiciona trilha sonora e efeitos sonoros, mixa com a voz, e entrega o vídeo final em -14 LUFS com créditos.

sonorizar 是什麼?

A habilidade 'sonorizar' é o quarto passo de um fluxo de edição de vídeo. Ela automatiza a adição de trilha sonora e efeitos sonoros a partir de uma pasta local (`marca/sons/`) ou, sob demanda, da biblioteca Epidemic Sound. O agente escolhe a trilha mais adequada ao clima do vídeo, posiciona os efeitos nos momentos-chave (inserções e transições), e mixa tudo respeitando a prioridade da voz (ducking automático). O resultado final é um vídeo com loudness normalizado a -14 LUFS e um arquivo de créditos. A ferramenta também suporta correções iterativas, como trocar a trilha ou ajustar volumes, sempre validando a mixagem antes da entrega.

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

/sonorizar · passo 4

A pessoa já tem o vídeo com as inserções (sequencia/3-insercoes.mp4). Você escolhe uma trilha e poucos efeitos, mostra a lista de sons, espera a confirmação, mixa e entrega sequencia/4-final.mp4.

Todo som sai de marca/sons/: trilhas em trilhas/, efeitos em efeitos/, e o creditos.md diz o clima de cada trilha e quando usar cada efeito. Sons de fora entram de duas formas, e apenas quando a pessoa solicitar: ela coloca o arquivo nessa pasta e informa a origem, ou solicita o Epidemic Sound (seção "Epidemic Sound", abaixo). Sem solicitação, use apenas o que já está na pasta. Efeito é arquivo gravado, usado como está. Nunca gere som por código (tom, ruído, síntese): fica metálico.

A voz manda: a trilha fica bem abaixo da fala e reduz automaticamente quando a pessoa fala. Efeito é pontuação: só onde algo acontece na tela, cada um com seu motivo.

Execute a partir da pasta da imersão. A saudação do primeiro uso e o tom da conversa estão no CLAUDE.md da pasta. Se sequencia/som/som.json já existe, é uma correção: vá para o passo 5.

1. Ler o vídeo e os sons

  • O vídeo: sequencia/insercoes/final-insercoes.mp4. Se o passo 3 não foi executado, use sequencia/decupagem/final.mp4 e informe em uma linha que o vídeo vai sem inserções.

  • A fala: sequencia/decupagem/palavras-corte.json. As inserções: sequencia/insercoes/insercoes.json (cada camadas[] com id, de e ate).

  • Os sons:

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

    e as tabelas de marca/sons/creditos.md (colunas Clima e Quando usar).

Escreva para você o clima do vídeo em uma frase e a lista de eventos: cada inserção que aparece, e a virada ou o fecho da fala, se houver.

2. Escolher

  • Trilha: a que combina com o clima do vídeo, pela coluna Clima. Uma só, do início ao fim.
  • Efeitos: um por inserção que aparece (o gancho fica mudo: nada no primeiro segundo) e, no máximo, um no fecho. O mesmo tipo de evento recebe o mesmo som. Em um vídeo de 20 s, isso dá 2 ou 3 efeitos.

Epidemic Sound (apenas quando a pessoa solicitar)

Aplica-se quando ela escreve "usa o Epidemic Sound", "pega uma trilha do Epidemic" ou algo similar.

  1. Verifique se o conector está nesta conversa: as ferramentas dele são SearchRecordings, DownloadRecording, SearchSoundEffects e DownloadSoundEffect. Sem elas, informe em uma linha que o Epidemic Sound requer a assinatura dela conectada ao Claude (Configurações › Conectores) e ofereça continuar com os sons da pasta.

  2. Trilha: SearchRecordings com o clima do vídeo em inglês, vocals: false e a faixa de BPM do clima. Escolha uma (duas, se ela pediu opções), informe título e autor e justifique a escolha.

  3. Efeito: SearchSoundEffects pelo nome do som. Use como veio, apenas cortado no tamanho do evento.

  4. Baixe na hora, porque o link expira em poucos minutos (DownloadRecording ou DownloadSoundEffect, em WAV):

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

    Efeito vai para marca/sons/efeitos/.

  5. Anote o som em marca/sons/creditos.md, em uma nova linha da tabela correta: arquivo, título, autor, Fonte Epidemic Sound, o ID da faixa, Licença Epidemic Sound, assinatura da conta conectada (não repassar o arquivo) e o clima. Sem essa linha, o sonorizar.py recusa o som.

  6. Siga para a lista de sons como com qualquer som da pasta. Informe à pessoa que essa trilha é da assinatura dela: serve nos vídeos dela enquanto a assinatura for válida, e o arquivo não deve ser repassado.

3. Lista de sons

Grave 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": "o título aparece em cima da cabeça"},
    {"camada": "etapas", "som": "whoosh", "volume": 0, "motivo": "o painel das 4 etapas aparece"}
  ]
}
  • Efeito de inserção usa "camada" (o id no insercoes.json); efeito na fala, usa "em" em uma âncora ("F6:Comenta"). volume de 0 a +5 (0 em cima da fala).
  • Título, autor e licença de cada som saem automaticamente de marca/sons/creditos.md.
  • Os outros campos estão em referencia.md; leia apenas se precisar de um.

Confira:

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

Pronto quando ele listar a trilha e os efeitos sem erro. O aviso "menos de 5 s depois do anterior" é esperado em um vídeo de 20 s com duas inserções: mantenha um efeito por inserção e não adicione outro próximo.

Envie no chat: a trilha (título e autor) e justificativa, e uma linha por efeito (segundo · som · motivo). Uma pergunta: "Posso mixar?"

4. Mixar e entregar

Com a confirmação ("Pode mixar."):

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

Leva de 15 s a 1 min por minuto de vídeo. Pronto quando exibir "Pronto", o volume final estiver até 1 de −14 LUFS e "Trilha embaixo da fala" indicar 20 ou mais. Abaixo de 20, adicione 4 ao abaixo_da_voz e mixe novamente.

Depois:

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

Ele copia o vídeo para sequencia/4-final.mp4, os créditos para sequencia/creditos.md e abre o vídeo.

Informe em uma linha onde está o vídeo final e que os créditos dos sons estão ao lado. Se o entregar.py exibiu o bloco RECADO DA IMERSÃO, repasse o texto do bloco como está, no final da resposta.

5. Corrigir

Altere apenas o que a pessoa solicitou no som.json, mixe e entregue novamente (passo 4):

PedidoO que alterar
"Troca a trilha por outra da pasta"o arquivo da trilha: o seguinte na listagem do sons.py; informe qual entrou (título e autor, do creditos.md)
"Usa uma trilha do Epidemic Sound"a seção "Epidemic Sound" do passo 2; depois troque o arquivo da trilha
"Tira o efeito do segundo 5"apague a linha do efeito que cai nesse segundo (o --resumo mostra os tempos)
"Música mais baixa"abaixo_da_voz + 4
"Música mais alta"abaixo_da_voz − 3, sem passar de 12; confira a linha "Trilha embaixo da fala" (20 ou mais)
"A música começa em outro ponto""inicio" na trilha, em segundos da música

Limites

  • O vídeo precisa ter a voz incorporada no próprio arquivo; a trilha e os efeitos entram por baixo dela.
  • A voz recebe apenas um filtro leve. Ruído de fundo, eco e vento permanecem como estão.
  • Trilha mais curta que o vídeo recomeça do início.
  • Esta etapa é mecânica: esforço baixo ou médio.

相關技能