audioproxy
Audioproxy es un proxy de transcodificación de audio 'on-the-fly' que genera variantes en tiempo real mediante ffmpeg a partir de fuentes locales o S3. Permite crear previews, archivos mono para ASR y normalización vía URL sin pre-renderizar.
Ficha actualizada 24 sept 2026, 9:35 · upstream 24 sept 2026, 9:26 · release v0.7.2
Qué es audioproxy
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Audioproxy es un proxy de transcodificación de audio 'on-the-fly' diseñado para generar variantes de archivos de audio bajo demanda directamente desde una URL, sin necesidad de pre-renderizar ni almacenar cada variante individualmente. Funciona montando un directorio local o conectándose a almacenamiento S3-compatible, procesando el audio en tiempo real mediante ffmpeg cuando se solicita una ruta específica con parámetros de transformación (formato, bitrate, duración, etc.). Esto permite servir previews cortos, archivos mono para reconocimiento de voz, normalización de podcasts o extractos FLAC sin duplicar recursos.
- Generación de previews de audio cortos (ej. 30s) para catálogos web.
- Preparación de archivos mono para sistemas de reconocimiento de voz (ASR).
- Normalización de volumen para podcasts o streaming.
- Extracción de datos de waveforms para visualizadores de música.
- Reducción de ancho de banda sirviendo versiones comprimidas (Opus/MP3) en lugar del original WAV.
- Provisión segura de contenido a terceros mediante URLs firmadas con expiración.
- Transcodificación 'on-the-fly' sin pre-renderizado masivo inicial.
- Caché de variantes persistente en S3 o local para reducir latencia futura.
- Soporte nativo para múltiples arquitecturas (amd64/arm64) en una sola imagen Docker.
- API basada puramente en URL con parámetros de transformación, sin cuerpo de solicitud.
- Integración con Erlang/OTP y Hex.pm para entornos BEAM.
- Documentación específica para agentes de IA mediante archivos llms.txt.
- Requiere ffmpeg instalado en el entorno del contenedor o nodo.
- Las fuentes HTTPS no están soportadas actualmente (solo S3 o local).
- El modo inseguro (AP_ALLOW_INSECURE) es solo para desarrollo y expone archivos si se activa en producción sin firma.
- No procesa video, rechaza entradas de video explícitamente.
- La API v0.x puede cambiar hasta la versión 1.0 establecida.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Pinning de versión es crucial por cambios en ffmpeg. Montar directorio local como read-only (:ro). Configurar AP_KEY y AP_SALT para producción, nunca usar AP_ALLOW_INSECURE. Definir AP_VARIANT_STORE para caché persistente. Usar ghcr.io/audioproxy/audioproxy:0.7.2 o :sha-<commit>.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.