Recorte de silencio automáticos

[dacacioa]

🎧 Mejoras en APPU: recorte automático del silencio, --no-upload, procesamiento avanzado de audio y documentación

📋 Resumen

Este PR introduce mejoras significativas a APPU enfocadas a evitar ediciones manuales, flexibilidad de uso, procesamiento de audio más sofisticado y documentación completa.

✨ Principales cambios:

🎛️ Procesamiento de Audio Mejorado

• ✂️ Recorte inteligente de silencios (clamp_silence): Detecta y acorta automáticamente los silencios largos (>900ms) a una duración máxima configurable, preservando bordes naturales con crossfades suaves
• 🔊 Normalización avanzada: Ahora incluye compresión dinámica suave para evitar saturación sin aplatar la dinámica del audio
• 🎶 Silencio de cola: Añade automáticamente 4 segundos de silencio al final del episodio
• 🎚️ Crossfades mejorados: Entrada del podcast con 800ms y outro con 500ms para transiciones naturales

🚀 Nuevas Funcionalidades

• 🚫 Flag --no-upload: Genera el archivo final sin subir a S3. Perfecto para testing y workflows locales
• 🔍 Descubrimiento automático de configuración: Busca config.cfg en múltiples rutas estándar (./cfg/, ./, ./appu/)
• 🪟 macOS Support: Añade filtros a .gitignore para archivos de sistema macOS (.DS_Store, .Spotlight-V100, ._*, etc.)

📚 Documentación Completa

• 📖 README.md completamente reestructurado con emoticones y tablas claras
• 🔧 Sección de "Flags & Options" con ejemplos prácticos
• 🛠️ "Troubleshooting" detallado
• 📦 Estructura del proyecto documentada
• 📝 Ejemplos de configuración listos para usar

🧪 Mejoras en Testing

• ✅ Tests añadidos para clamp_silence() y add_tail_silence()
• 📊 Validación de duración de audio procesado

📦 Dependencias

• ⬆️ pydub actualizado a 0.25.1 (mejor soporte de compresión y silencio)

🎯 Impacto

• ✔️ Usuarios: Más control sobre el flujo de trabajo, mejor documentación, audio procesado con mejor calidad
• ✔️ Contribuidores: Código más limpio, tests adicionales, decisiones de audio documentadas
• ✔️ macOS: Repositorio más limpio sin archivos de sistema

🔗 Tipos de cambios

• 🎯 Nueva funcionalidad (--no-upload, recorte de silencios, compresión)
• 📖 Documentación (README completo con ejemplos)
• 🧪 Tests (nuevas pruebas unitarias)
• 🔧 Configuración (.gitignore para macOS)
• ⬆️ Dependencias (pydub actualizado)

✅ Checklist

• Código siguiendo estándares del proyecto
• Tests añadidos y pasando
• Documentación actualizada
• Sin cambios rotos en funcionalidad existente
• Ejemplo de configuración funcional incluido