Communitygithub.com

sound-design

Design de som para vídeos de produto, lançamento e redes sociais no Remotion: uma base musical suave, um efeito sonoro real para cada clique, tecla, alternância, sucesso e transição, narração sob demanda, mixagem de níveis e loudness. Use sempre que um vídeo tiver áudio, junto com video-rules e motion-direction.

O que é sound-design?

O skill **sound-design** garante que qualquer vídeo gerado no Remotion tenha uma trilha sonora profissional e imersiva, elevando a percepção de qualidade. Ele define regras claras para a camada de áudio, incluindo uma base musical instrumental suave (music bed) e efeitos sonoros reais (SFX) para cada interação visível — cliques, teclas, toggles, notificações, transições e momentos de destaque. A abordagem evita a síntese de som em código, usando amostras gravadas reais licenciadas (como a biblioteca CC0 da coldframe) ou fornecidas pelo usuário (Pixabay, ElevenLabs). O skill também gerencia a sincronização precisa dos sons com os frames de animação, a mixagem de níveis e loudness (alvo de -14 LUFS integrado), e inclui um processo de aprovação do áudio antes do render final. Suporta Remotion e é ativado em conjunto com os skills video-rules e motion-direction.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/shafeen003/remotion_project/tree/HEAD/.claude/skills/sound-design

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Sound design

O som é metade do que faz um filme parecer caro. Cada ação visível recebe um som que a combina, uma base musical suave carrega o filme inteiro, e a mixagem é limpa e alta o suficiente sem distorção.

Nunca sintetize a trilha sonora em código (ruído numpy, pads senoidais, bipes). Isso soou mal e foi cortado do filme de lançamento da coldframe. Use efeitos sonoros reais gravados e música real.

1. Camadas

  1. Base musical (sempre, a menos que a entrega seja silenciosa): suave, instrumental, andamento constante, sem vocais. Ambient/electrónica/piano suave para ferramentas de desenvolvimento; fica por baixo de tudo.
  2. Efeitos sonoros de UI: um para cada interação visível.
  3. Efeitos sonoros de transição: whooshes, swishes, risers, impacts para movimentos de câmera e cortes.
  4. Narração (apenas se o usuário pedir): gravada ou TTS de alta qualidade aprovada pelo usuário; sempre com legendas fixas.

2. Fontes

O quêOndeNotas
SFX de UI + transiçãopublic/sfx/: a biblioteca coldframe (§5)CC0 (Kenney, Remotion @remotion/sfx); seguro para commit e redistribuição
Mais SFXPacotes de áudio Kenney (CC0), @remotion/sfx (licença por som na sua página), Freesound (filtrar CC0)Registre a fonte + licença em library.json
MúsicaO usuário escolhe: Pixabay Music (gratuito, sem atribuição), Chosic filtro CC0, YouTube Audio Library, ou uma faixa de sua propriedadeOfereça 2–3 opções que combinem com o clima; não faça commit de faixas Pixabay/YouTube em um repositório público (suas licenças proíbem redistribuir o arquivo em si); mantenha-as no public/music/ do projeto em um repositório privado ou adicione ao .gitignore e faça upload para o render
SFX / música / narração gerados por IAElevenLabs (efeitos sonoros, música, TTS) ou similar, apenas com a chave de API e OK do usuárioOuça e aprove antes de usar

3. Corresponda cada som à sua ação

Escolha pelo que o elemento é, o quão pesado ele é, e o que acabou de acontecer. Nunca reutilize a mesma amostra exata duas vezes seguidas: alterne variantes e varie playbackRate 0.96–1.04 e ganho ±2 dB.

Na telaSomNível vs. música
Clique do cursor num pequeno controle (aba, link, ícone)clique suave / ticksutil, +3 dB
Pressionamento de botão primário (Executar, Render, Implantar, CTA)clique mais firme com um pouco de corpo+6 dB
Alternância / interruptor / checkboxswitch (dois estados), variante ligado ≠ desligado+4 dB
Digitação em um terminal/inputtoques de tecla, um a cada 1–3 caracteres, variados; um pouco mais alto no Entersutil
Hover / foco / seleção se movendotick muito suave, ou nadaquase inaudível
Cartão ou painel pousa / encaixa no lugarqueda / toque suave+4 dB
Notificação, badge, contador concluipop / sino suave+5 dB
Sucesso / verificado / concluídosom de confirmação (o som "recompensa" único)+6 dB
Erro / falha (apenas se mostrado)zumbido baixo e abafado, curto+4 dB
Movimento de câmera, fly-in, whip panwhoosh / swish cujo pico coincide com o frame mais rápido+4 dB
Impacto de paleta / grande revelaçãoimpact (batida baixa), com um riser antes se tiver sido adicionado à biblioteca+8 dB, o momento mais alto
Logo / cartão finalbatida suave + a frase resolutiva da música+6 dB

Agrupe os sons para que o filme tenha 3–4 famílias reconhecíveis (cliques, whooshes, um som de recompensa, um impacto), não 30 aleatórios.

4. Sincronia

  • Cliques e toques: no frame em que o botão visualmente pressiona (ou 1 frame antes; o som parece atrasado caso contrário).
  • Whooshes: comece cedo para que o pico caia no frame mais rápido do movimento.
  • Impactos: exatamente no frame do impacto/flash. Deixe 3–8 frames de quase silêncio antes de uma grande revelação (abaixe a música).
  • Corte na batida da música quando possível: escolha o bpm e ajuste os inícios das cenas às batidas (frames por batida = fps * 60 / bpm).

5. Construa no Remotion

coldframe setup instala a biblioteca em public/sfx/ (37 sons CC0 em 17 papéis, aparados para começar no frame, com loudness igualado; fontes em public/sfx/LICENSE.md, detalhes em library.json) e os helpers em src/coldframe-sound.tsx.

PapelUso
click-softclique num pequeno controle (aba, link, ícone)
click-firmpressionamento num botão primário (Executar, Render, CTA)
tickhover / foco / seleção se movendo
key, key-enterdigitação; Enter no final de um comando
toggle-on, toggle-offinterruptores, checkboxes
selectopção escolhida numa lista
dropcartão/painel pousa e encaixa no lugar
popnotificação, badge, pequeno item aparece
confirmsucesso / verificado / concluído (o som de recompensa único)
erroruma falha mostrada na tela
open, closepainel/janela expande ou colapsa (pico alinhado)
whooshmovimento de câmera, fly-in, whip pan (pico alinhado)
impact-softelemento pousa com peso, acento de batida
impacto grande momento: impacto de paleta, revelação, logo
import { MusicBed, Sfx, typingCues } from "./coldframe-sound";

<MusicBed src="music/bed.mp3" volume={0.35} duckAt={[REVEAL]} />
<Sfx role="click-firm" at={PRESS} />                 // o frame em que o botão visualmente pressiona
<Sfx role="whoosh" at={FASTEST_FRAME} />             // o pico cai em `at` automaticamente
{typingCues(TYPE_START, TYPE_END, cmd.length).map((f) => <Sfx key={f} role="key" at={f} />)}
<Sfx role="key-enter" at={ENTER} />
<Sfx role="confirm" at={RESULT} />
<Sfx role="impact" at={REVEAL} />
  • As variantes rotacionam e playbackRate varia ±3% automaticamente, então cliques repetidos nunca soam idênticos.
  • Mantenha cada frame de cue no mesmo objeto de configuração que os visuais (frames relativos à cena), para que som e imagem não possam divergir.
  • Comece com volume 1 para efeitos e 0.3–0.4 para a base musical, depois ajuste medindo (§6).
  • Audite toda a biblioteca: a composição SfxAudition do projeto exemplo (npx remotion render SfxAudition out/sfx-audition.wav --codec=wav).
  • Precisa de um som que a biblioteca não tem (riser, batida grave profunda, ambiência)? Adicione um arquivo CC0 a public/sfx/, anote sua fonte em LICENSE.md e peça a aprovação do usuário.

Os chunks da coldframe carregam sua fatia de áudio como PCM sem perdas, então várias tags <Audio> sobrepostas renderizam e juntam exatamente na amostra na nuvem.

6. Níveis e loudness

  • Mixagem final: cerca de -14 LUFS integrado (YouTube, redes sociais), pico verdadeiro ≤ -1 dBTP. As versões web hero/README são enviadas silenciosas (remover áudio: ffmpeg -i in.mp4 -an -c:v copy out.mp4).
  • A base musical fica bem abaixo dos efeitos (aproximadamente -24 a -20 LUFS por conta própria); atenue-a 6–10 dB durante a narração e antes da grande revelação.
  • Medição: ffmpeg -i out.mp4 -af loudnorm=print_format=json -f null - (integrado, pico verdadeiro) e -af volumedetect (pico). Use o ffmpeg do sistema; o embutido do Remotion não tem esses filtros.
  • Sem distorção, sem bombeamento, nenhum efeito sonoro mais alto que o único momento de impacto.

7. Aprovação antes do render completo

  1. Renderize apenas o áudio, localmente (barato, sem quadros de vídeo): npx remotion render <Comp> out/audio-preview.wav --codec=wav. Para filmes longos, corte uma amostra de 10–15 s ao redor da parte mais movimentada.
  2. Envie ao usuário com uma lista de cues de uma linha ("0:03 whoosh de fly-in, 0:07 clique, 0:09 sino de sucesso…") e aguarde a aprovação.
  3. Só então renderize o vídeo na nuvem com a coldframe.

8. Checklist

  • Base musical escolhida pelo usuário (2–3 opções oferecidas), licença anotada, fade in e out limpos.
  • Cada clique visível, tecla, alternância, pouso, sucesso e movimento de câmera tem um som correspondente; nada visível acontece em silêncio, a menos que intencional.
  • 3–4 famílias de som, variantes rotacionadas, nenhuma repetição idêntica consecutiva.
  • Impactos no frame, picos de whoosh no frame mais rápido, cliques no frame de pressionamento.
  • ~-14 LUFS integrado, pico verdadeiro ≤ -1 dBTP, sem distorção (medido).
  • Amostra de áudio aprovada pelo usuário antes do render na nuvem.
  • Versão silenciosa exportada para README / hero do site.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Habilidades Relacionadas