Configuración de FFmpeg
Cómo Cliply gestiona FFmpeg para el procesamiento local de video.
FFmpeg es la herramienta de procesamiento de video que impulsa la exportación de clips y la extracción de cuadros congelados en la app de escritorio de Cliply. No necesitás instalarlo manualmente — Cliply descarga y gestiona su propia copia en el primer uso.
Cómo funciona
La primera vez que intentás exportar un clip o extraer un cuadro congelado, la app verifica si hay un binario de FFmpeg disponible. El orden de resolución es:
- Binario gestionado — una copia que Cliply descargó previamente en la carpeta de datos de la app
- Variable de entorno — una ruta establecida mediante
FFMPEG_PATH(para usuarios avanzados) - Homebrew (Apple Silicon) —
/opt/homebrew/bin/ffmpegsi está presente - Homebrew (Intel / manual) —
/usr/local/bin/ffmpegsi está presente
Si no se encuentra ninguno de estos, la app muestra un banner de Descargar FFmpeg.
Descarga con un clic
Mirá el banner
Cuando intentás exportar sin FFmpeg disponible, aparece un banner: "FFmpeg necesario — descarga única de aproximadamente 60 MB."
Hacé clic en Descargar
Hacé clic en el botón Descargar. Una barra de progreso muestra el estado de la descarga. El binario se obtiene desde el servidor de versiones de Cliply, no directamente de un tercero.
Verificación del checksum
Después de completar la descarga, la app verifica el checksum SHA-256 del archivo antes de aceptarlo. Si el checksum no coincide, el archivo se descarta y el banner vuelve a aparecer.
Listo
El botón de exportación se rehabilita inmediatamente. El binario se almacena en la carpeta de datos de la app y se reutiliza entre sesiones.
Dónde se almacena el binario
El binario gestionado vive en:
~/Library/Application Support/app.cliply.desktop/bin/ffmpeg
(La ruta de la carpeta usa app.cliply.desktop.dev durante el desarrollo.)
Para forzar una nueva descarga — por ejemplo, si el binario se corrompe — eliminá el directorio bin/. La app detectará el binario faltante y mostrará el banner de descarga nuevamente.
Por qué Cliply no incluye FFmpeg en el paquete
FFmpeg no está incluido en la descarga de la app por dos razones:
- Cumplimiento de licencia. Distribuir un build común de FFmpeg incluiría codecs con licencia GPL. Cliply usa el encoder H.264 nativo de Apple (
h264_videotoolbox) para mantenerse limpio de licencias. La descarga gestionada traslada la responsabilidad de cumplimiento GPL a la máquina del usuario. - Tamaño de descarga. Un binario estático de FFmpeg agrega aproximadamente 100 MB a cada instalación, la mayoría de los cuales la mayoría de los usuarios nunca usará en la primera sesión.
Solución de problemas
| Problema | Solución |
|---|---|
| La descarga falla inmediatamente | Revisá tu conexión a internet y reintentá |
| Error "Checksum no coincide" | Reintentá la descarga — el archivo puede haberse corrompido en tránsito |
| La exportación falla después de descargar | Eliminá ~/Library/Application Support/app.cliply.desktop/bin/ y reintentá — la app descargará una copia nueva |
| Ya tenés FFmpeg de Homebrew | La app lo encontrará automáticamente; no se necesita descarga |
La descarga gestionada es solo para Apple Silicon (arm64). En una Mac Intel, instalá FFmpeg mediante Homebrew (brew install ffmpeg) y la app lo tomará desde /usr/local/bin/ffmpeg.