renezander030/capcut-cli

¿Qué es?

Funciones clave

• 01Edita el JSON de borradores locales de CapCut y JianYing, y mantiene las pistas editables en la aplicación.
• 02Añade video, audio y texto, y aplica recortes, cambios de velocidad y volumen, y transiciones.
• 03Importa y exporta subtítulos SRT y VTT, con subtítulos a nivel de palabra.
• 04Divide grabaciones largas en clips cortos mediante la detección de silencios, escenas y tomas repetidas.
• 05Ofrece una CLI, una biblioteca tipada y un ejecutor de colas JSONL para automatizar tareas.

Casos de uso

• Convertir grabaciones largas en videos cortos con subtítulos, por lotes.
• Generar o corregir subtítulos de un proyecto de CapCut existente a partir de un archivo SRT.
• Permitir que un agente LLM inspeccione o cree borradores mediante una interfaz de comandos determinista.
• Crear versiones de un borrador en varios idiomas con los subtítulos traducidos.

Inicio rápido

1. 1

   Instala la CLI globalmente desde npm

   npm install -g capcut-cli
2. 2

   Comprueba la configuración con el comando doctor

   capcut doctor
3. 3

   Crea un primer proyecto con un video y subtítulos

   capcut quickstart my-first --video clip.mp4 --srt captions.srt
4. 4

   Examina el proyecto en un formato legible

   capcut info ./my-first/ -H

Antes de usarlo

• !Requiere Node 18 o posterior; algunos comandos necesitan herramientas opcionales como Whisper, FFmpeg y una clave de API de Anthropic.
• !Es un proyecto comunitario no oficial y no está afiliado a CapCut ni a ByteDance.
• !El resultado debe abrirse y renderizarse en CapCut o JianYing; la herramienta no publica ni renderiza el video final.

Temas

Preguntas frecuentes

¿Qué es capcut-cli?

Herramienta de línea de comandos y biblioteca para editar proyectos de borrador de CapCut / JianYing como JSON local, sin necesidad de API ni servidor. capcut-cli crea y edita proyectos reales de CapCut y JianYing (剪映) trabajando directamente con el almacén local de borradores. Cada comando lee JSON y vuelve a escribir JSON, por lo que el resultado se abre en CapCut con los videos, subtítulos y demás pistas todavía editables, en lugar de ser una exportación aplanada. Permite realizar tareas como añadir archivos multimedia y texto, recortar, cambiar la velocidad y el volumen, aplicar transiciones y plantillas, e importar y exportar subtítulos SRT o VTT.

¿capcut-cli es gratuito? ¿Qué licencia tiene?

capcut-cli es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿capcut-cli sigue mantenido?

Mantenimiento activo. El último commit de capcut-cli fue el 19 oct 2026.

¿Para qué puedo usar capcut-cli?

Convertir grabaciones largas en videos cortos con subtítulos, por lotes. Generar o corregir subtítulos de un proyecto de CapCut existente a partir de un archivo SRT. Permitir que un agente LLM inspeccione o cree borradores mediante una interfaz de comandos determinista. Crear versiones de un borrador en varios idiomas con los subtítulos traducidos.

¿Cómo se instala capcut-cli?

Instala la CLI globalmente desde npm: npm install -g capcut-cli Comprueba la configuración con el comando doctor: capcut doctor Crea un primer proyecto con un video y subtítulos: capcut quickstart my-first --video clip.mp4 --srt captions.srt Examina el proyecto en un formato legible: capcut info ./my-first/ -H

¿Dónde consigo capcut-cli?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/renezander030/capcut-cli