Procesamiento general de audio
Operaciones generales de audio además de reducción de ruido: recorte, transcodificación, normalización de volumen, extracción de pistas, concatenación, fundido entrada/salida, cambio de velocidad. Todo a través del script compartido skills/shared/scripts/audio_ops.py que encapsula ffmpeg, con parámetros deterministas y reproducibles, sin construir comandos manualmente.
Entrada
| Campo | Obligatorio | Descripción |
|---|---|---|
| input_file | Sí | Ruta del archivo de audio o video |
| operation | Sí | trim / convert / normalize / extract / concat / fade / speed / denoise / info |
| output_file | No | Por defecto outputs/nombre-del-tema/{name}-{op}.{ext} |
Formatos soportados: wav / mp3 / m4a / aac / flac, contenedores de video mp4 / mkv / mov (para extracción de pistas).
Salida
- Archivo de audio procesado (guardado en
outputs/nombre-del-tema/). - Cada operación imprime el comando ffmpeg realmente ejecutado junto con la duración/bitrate/canales/frecuencia de muestreo del archivo de salida.
Pasos de ejecución
Ruta del script (relativa a la raíz del proyecto): skills/shared/scripts/audio_ops.py. Cada subcomando admite -h.
0. Verificación del entorno + sondeo
python skills/shared/scripts/audio_ops.py info input.mp3
El script verifica automáticamente ffmpeg/ffprobe y muestra instrucciones de instalación si faltan. Ejecute info primero para ver la duración/bitrate/canales del archivo antes de proceder.
1. Recorte trim
# Tiempos de inicio y fin
python skills/shared/scripts/audio_ops.py trim in.mp3 -o outputs/nombre-del-tema/clip.mp3 --start 00:00:05 --end 00:00:20
# Inicio + duración
python skills/shared/scripts/audio_ops.py trim in.mp3 -o clip.mp3 --start 5 --duration 15
2. Transcodificación convert
python skills/shared/scripts/audio_ops.py convert in.wav -o out.mp3 --bitrate 192k
python skills/shared/scripts/audio_ops.py convert in.m4a -o out.wav --sample-rate 44100 --channels 2
El formato de salida se determina por la extensión (mp3/wav/m4a/aac).
3. Normalización de volumen normalize
python skills/shared/scripts/audio_ops.py normalize in.mp3 -o out.mp3
Por defecto normaliza con loudnorm a -14 LUFS / -1.5 dBTP (volumen estándar para redes sociales/podcasts). Se puede sobrescribir con --i --tp --lra.
4. Extracción de pistas extract
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.m4a
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.aac --copy # Sin recodificación, más rápido
5. Concatenación concat
python skills/shared/scripts/audio_ops.py concat a.mp3 b.mp3 c.mp3 -o all.mp3
Concatena en el orden de los parámetros, recodificando para compatibilidad entre diferentes frecuencias de muestreo/contenedores.
6. Fundido entrada/salida fade
python skills/shared/scripts/audio_ops.py fade in.mp3 -o out.mp3 --fade-in 2 --fade-out 3
--fade-out se aplica automáticamente N segundos antes del final.
7. Cambio de velocidad speed (manteniendo el tono)
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 1.5 # 1.5x velocidad
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 0.8 # ralentizar
Basado en atempo para preservar el tono; se encadena automáticamente más allá del rango 0.5-2.0.
8. Reducción de ruido denoise (respaldo; para casos específicos use audio-denoise)
python skills/shared/scripts/audio_ops.py denoise in.wav -o out.wav --tier 2
Límites con audio-denoise
- audio-denoise: SKILL especializado en reducción de ruido, que se encarga de la selección de nivel, descarga de modelos, informes de reducción, etc. — Úselo cuando necesite una reducción de ruido seria.
- audio-editing: Procesamiento general de audio. El subcomando
denoisesolo sirve como respaldo práctico. Ambos llaman al mismoaudio_ops.py denoise, tienen la misma capacidad, pero diferente propósito.
Reglas
- Nunca eliminar el archivo original — Solo escribir nuevos archivos en
outputs/nombre-del-tema/. - Primero info, luego procesar — Mostrar información del archivo para evitar operaciones incorrectas.
- Entrada de video solo modifica el audio — denoise aplica automáticamente
-c:v copyen video; para extracción pura use extract. - Ejecución transparente — El script imprime el comando ffmpeg real.
- Funciona sin Profile — El procesamiento de audio no depende del perfil del usuario.
Perfil (Profile)
Si hay un Profile, se pueden seleccionar parámetros predeterminados según la plataforma preferida (por ejemplo, loudness para videos cortos, bitrate objetivo). Sin Profile, se usan valores generales por defecto (-14 LUFS, 192k).