dotslashsimran/clean-audio

Limpiar audio

Ejecutar con el Python de la habilidad rough-cut: PY=~/simcraft/skills/rough-cut/.venv/bin/python (ejecuta sh ~/simcraft/skills/rough-cut/setup.sh una vez si no existe). Comparte los ayudantes de rough-cut y usa Whisper para la verificación de claridad.

Pasos

1. Prueba de escucha primero. Crea un antes/después de 10 segundos del momento de conversación más intenso. Ambos se configuran con la misma sonoridad, por lo que la comparación es sobre calidad, no sobre volumen:

   $PY scripts/clean_audio.py <video> --sample
   

   Abre ambos archivos wav para el usuario (open <antes> <después>) y dale el informe.

2. Aplicar. Hay dos formas de ejecutarlo:

   • En un espacio de trabajo de rough-cut, antes de renderizar. Limpia cada clip original en audio/<clip>.clean.wav, y render.py de rough-cut los usa automáticamente:

     $PY scripts/clean_audio.py <workspace>
     

     Luego renderiza y verifica como de costumbre. El informe se guarda en audio/cleanup.md.
   • Sobre un solo vídeo. Escribe <nombre>_clean.<ext> junto al original, con el vídeo copiado sin modificar:

     $PY scripts/clean_audio.py <video>
     

3. Informe en palabras simples:

   • la diferencia entre voz y fondo antes y después,
   • la sonoridad final,
   • lo que se encontró (zumbido, recorte),
   • la intensidad que la verificación de claridad seleccionó.

   Si el informe dice que el ruido restante son voces o música, dile al usuario que estos filtros no pueden eliminarlo y sugiere un aislador de voz por IA.

Opciones

• --strength strong|medium|light establece la desruido más intensa a probar. El valor predeterminado es medium, y la verificación de claridad la reduce automáticamente.
• --target -14 establece la sonoridad en LUFS. -14 es adecuado para YouTube, Instagram y TikTok; usa -16 para podcasts.
• --no-eq omite el moldeado del tono, si al usuario le gusta su voz tal como es.

Reglas

• Limpia los clips originales antes de cortar, no después. El ruido se aprende de una pausa, y el rough-cut elimina las pausas.
• Nunca toques los archivos originales.
• Nunca sacrifiques claridad por silencio. La verificación de claridad lo garantiza: sin palabras perdidas y confianza dentro de 0.015 del original.
• No empujes el audio al silencio digital entre palabras. Se mantiene un poco de sonido ambiente a propósito.

Qué hace cada paso, por qué está construido así y los números de prueba: reference.md.