FUN SFX
Usa esta carpeta como raíz de la habilidad. Resuelve su ubicación antes de ejecutar comandos; el directorio de trabajo del usuario puede estar en otro lugar. Python 3.10+ permite la exploración; la exportación de audio también necesita FFmpeg en el PATH.
Encontrar el sonido
Ejecuta python3 <ruta-raíz-habilidad>/scripts/sfx.py search "swish" --json para obtener candidatos con rutas de audio absolutas. La búsqueda también acepta descripciones de escenas como "intento fallido" o "captura de foto". Coincide con títulos, IDs, categorías, etiquetas, usos recomendados y ejemplos; varias palabras deben coincidir todas. Excluye deliberadamente guía negativa. Ejecuta list --json para la colección completa o show <id> para un registro completo. Lee el catálogo para una vista general legible.
Cada grabación suministrada tiene una guía de caso de uso individual: escenas recomendadas, sincronización, situaciones a evitar y un ejemplo de edición. Usa los campos de usage del registro para elegir un sonido para la escena, no solo una categoría coincidente. Estas son recomendaciones creativas, no usos obligatorios.
Las etiquetas se derivan del nombre de archivo. Verifica audio_review.status: siete grabaciones tienen notas automatizadas de análisis de audio; las otras 64 tienen recomendaciones basadas en el nombre de archivo con contenido audible no confirmado. Las notas automatizadas también pueden malinterpretar el habla; presta atención a audio_review.uncertainty. Ninguna grabación se declara como audicionada por humanos. Audiciona los candidatos antes de elegirlos, especialmente nombres vagos como Walmart, Whoop o Spotlight. Los archivos pueden contener habla, música, silencio, varios efectos o cambios abruptos de volumen. La colección de swishes cinematográficos y el clip largo de terror necesitan extractos seleccionados. La guía de sincronización es relativa a la acción visual, no un punto de entrada/salida verificado en la fuente.
Preparar el cue
python3 <ruta-raíz-habilidad>/scripts/sfx.py export <id> /ruta/absoluta/salida/cue.wav --inicio 0.2 --duración 0.8 --ganancia-db -8 --fundido-ms 10
La salida es WAV PCM estéreo a 48 kHz. --inicio es un desplazamiento en la fuente; la colocación en la línea de tiempo es una edición separada. El comando rechaza una salida existente. Mantén las grabaciones originales intactas. Usa ganancia moderada, preserva la inteligibilidad del diálogo y audiciona la mezcla final; un solo ajuste de volumen no será adecuado para cada grabación.
Usa el editor de video existente del usuario o herramientas de edición para colocar el cue preparado. Lee editing.md para campos de hoja de cue, guía de sincronización y ejemplos de mezcla con FFmpeg. Registra el ID elegido, el extracto de la fuente, la posición en la línea de tiempo y la ganancia para que la edición sea reproducible. No añadas sonido a cada corte por defecto.
Derechos e integridad
El mantenedor de FUN SFX no posee ninguno de los sonidos empaquetados. Todos los derechos permanecen con sus respectivos propietarios. Conserva este aviso de propiedad al presentar o empaquetar la colección de sonidos.
El código y la documentación tienen licencia MIT. Las grabaciones empaquetadas y el audio extraído tienen derechos no verificados y están excluidas de esa licencia; consulta ASSET_LICENSE.md. No describas las grabaciones como MIT, libres de regalías o autorizadas para redistribución. Un nombre de archivo que contenga "sin copyright" no es evidencia de licencia. Conserva esta distinción al entregar una edición o empaquetar esta habilidad.
Ejecuta python3 <ruta-raíz-habilidad>/scripts/sfx.py verify al verificar una descarga o un paquete modificado. catalog.json contiene rutas portátiles, metadatos técnicos y sumas de verificación SHA-256 para cada archivo de audio original y utilizable.