FUN SFX
Use esta pasta como raiz da skill. Resolva sua localização antes de executar comandos; o diretório de trabalho do usuário pode ser outro. Python 3.10+ é necessário para a descoberta; a exportação de áudio também precisa do FFmpeg no PATH.
Encontrar o som
Execute python3 <skill-root>/scripts/sfx.py search "whoosh" --json para obter candidatos com caminhos de áudio absolutos. A pesquisa também aceita descrições de cena como "tentativa falha" ou "captura de foto". Ela corresponde a títulos, IDs, categorias, tags, usos recomendados e exemplos; várias palavras devem corresponder todas. Exclui deliberadamente orientações negativas. Execute list --json para a coleção completa ou show <id> para um registro completo. Leia o catálogo para uma visão geral legível.
Cada gravação fornecida tem um guia de caso de uso individual: cenas recomendadas, temporização, situações a evitar e um exemplo de edição. Use os campos usage do registro para escolher um som para a cena, não apenas uma categoria correspondente. Estas são recomendações criativas, não usos obrigatórios.
As tags são derivadas do nome do arquivo. Verifique audio_review.status: sete gravações têm notas automatizadas de análise de áudio; as outras 64 têm recomendações baseadas no nome do arquivo com conteúdo audível não confirmado. As notas automatizadas também podem interpretar errado a fala; atente para audio_review.uncertainty. Nenhuma gravação tem garantia de ter sido auditada por humanos. Audite os candidatos antes de escolhê-los, especialmente nomes vagos como Walmart, Whoop ou Spotlight. Os arquivos podem conter fala, música, silêncio, vários efeitos ou mudanças abruptas de volume. A coleção cinematic-whoosh e o clipe longo de horror precisam de trechos selecionados. As orientações de temporização são relativas à ação visual, não a um ponto de entrada/saída verificado.
Preparar o cue
python3 <skill-root>/scripts/sfx.py export <id> /absolute/output/cue.wav --start 0.2 --duration 0.8 --gain-db -8 --fade-ms 10
A saída é um WAV PCM estéreo a 48 kHz. --start é um deslocamento na fonte; o posicionamento na linha do tempo é uma edição separada. O comando recusa uma saída existente. Mantenha as gravações originais intactas. Use ganho moderado, preserve a inteligibilidade do diálogo e audite a mixagem final; uma única configuração de volume não servirá para todas as gravações.
Use o editor de vídeo existente do usuário ou ferramentas de edição para posicionar o cue preparado. Leia editing.md para campos de cue sheet, orientações de temporização e exemplos de mixagem com FFmpeg. Registre o ID escolhido, o trecho da fonte, a posição na linha do tempo e o ganho para que a edição seja reproduzível. Não adicione som a todos os cortes por padrão.
Direitos e integridade
O mantenedor do FUN SFX não é proprietário de nenhum dos sons incluídos. Todos os direitos permanecem com seus respectivos proprietários. Preserve este aviso de propriedade ao apresentar ou empacotar a coleção de sons.
O código e a documentação são licenciados sob MIT. As gravações incluídas e o áudio extraído têm direitos não verificados e estão excluídos dessa licença; veja ASSET_LICENSE.md. Não descreva as gravações como MIT, royalty-free ou liberadas para redistribuição. Um nome de arquivo contendo "no copyright" não é evidência de licença. Preserve esta distinção ao entregar uma edição ou empacotar esta skill.
Execute python3 <skill-root>/scripts/sfx.py verify ao verificar um download ou pacote modificado. catalog.json contém caminhos portáteis, metadados técnicos e somas SHA-256 para cada arquivo de áudio original e utilizável.