CLI de FFHub — FFmpeg desde la línea de comandos

El CLI de FFHub te permite ejecutar tareas de FFmpeg directamente desde tu terminal. Los archivos locales se suben automáticamente a la nube para su procesamiento.

Requisitos previos

Necesitas tener instalado Node.js 18 o una versión más reciente. Verifica con:

node --version

Si no tienes Node instalado, descárgalo desde nodejs.org (la versión LTS es suficiente).

Instalación

Instálalo de forma global para poder escribir ffhub desde cualquier ubicación en tu terminal:

npm install -g ffhub

El flag -g significa "global" — instala el comando en el PATH del sistema en lugar de una carpeta node_modules local. Verifica que funcionó:

ffhub help

Deberías ver una lista de comandos. Si la terminal indica command not found: ffhub, consulta la sección Resolución de problemas más abajo.

Actualizar a la última versión

npm install -g ffhub@latest

Sin instalación global (npx)

Si prefieres no instalar globalmente, todos los comandos de esta documentación funcionan con npx ffhub en lugar de ffhub — npm descarga la última versión bajo demanda:

npx ffhub "ffmpeg -i input.mp4 -c:v libx264 output.mp4"

Un poco más lento en la primera ejecución (descarga el paquete), pero no requiere instalación global.

Configuración

Establece tu clave API usando el CLI:

ffhub config YOUR_API_KEY

O usa una variable de entorno:

export FFHUB_API_KEY=YOUR_API_KEY

Ejemplos de uso

Transcodificar un video

ffhub "ffmpeg -i input.mov -c:v libx264 -preset fast output.mp4"

Comprimir un video

ffhub "ffmpeg -i input.mp4 -c:v libx264 -crf 28 output.mp4"

Extraer audio

ffhub "ffmpeg -i video.mp4 -vn -c:a libmp3lame audio.mp3"

Cuando el archivo de entrada es una ruta local, el CLI lo sube automáticamente antes de ejecutar el comando. Una vez que la tarea finaliza, el archivo de salida se descarga a tu directorio actual.

Referencia de comandos

Comando	Descripción
ffhub [args]	Crear y ejecutar una tarea de FFmpeg
ffhub whoami	Mostrar información del usuario actual
ffhub list	Listar las tareas recientes
ffhub status <task_id>	Consultar el estado de una tarea
ffhub config <api_key>	Guardar la clave API en la configuración
ffhub help	Mostrar el mensaje de ayuda

Resolución de problemas

command not found: ffhub

Después de npm install -g, el binario ffhub se ubica en la carpeta global de binarios de npm, pero esa carpeta debe estar en el $PATH. Verifica:

npm prefix -g       # ej. /usr/local
echo $PATH | tr ':' '\n' | grep -i bin

El primer comando muestra dónde npm instala los paquetes globales. Confirma que <esa ruta>/bin aparezca en la salida del segundo comando. Si no aparece, agrega esta línea a la configuración de tu shell (~/.zshrc, ~/.bashrc, etc.):

export PATH="$(npm prefix -g)/bin:$PATH"

Reinicia tu terminal y ffhub help debería funcionar.

Errores de permisos en npm install -g

Si ves errores EACCES, la carpeta global de npm necesita permisos de administrador. Puedes ejecutar sudo npm install -g ffhub, o (mejor opción) configurar npm para usar una carpeta con permisos de escritura para tu usuario — consulta la documentación de npm sobre cómo corregir permisos.

Enlaces

• Paquete npm: ffhub en npm