¿Qué hace cli-anything-kdenlive?
Una interfaz de línea de comandos con estado para edición de video, que sigue los mismos patrones que el CLI de Blender. Utiliza un formato de proyecto JSON con generación de XML MLT para Kdenlive/melt.
Instalación
Este CLI se instala como parte del paquete cli-anything-kdenlive:
pip install cli-anything-kdenlive
Requisitos previos:
- Python 3.10+
- kdenlive debe estar instalado en tu sistema
Uso
Comandos básicos
# Mostrar ayuda
cli-anything-kdenlive --help
# Iniciar modo REPL interactivo
cli-anything-kdenlive
# Crear un nuevo proyecto
cli-anything-kdenlive project new -o project.json
# Ejecutar con salida JSON (para consumo por agentes)
cli-anything-kdenlive --json project info -p project.json
Modo REPL
Cuando se invoca sin un subcomando, el CLI entra en una sesión REPL interactiva:
cli-anything-kdenlive
# Introduce comandos de forma interactiva con autocompletado e historial
Grupos de comandos
Proyecto
Comandos de gestión de proyectos.
| Comando | Descripción |
|---|---|
new | Crear un nuevo proyecto |
open | Abrir un proyecto existente |
save | Guardar el proyecto actual |
info | Mostrar información del proyecto |
profiles | Listar perfiles de video disponibles |
json | Imprimir el proyecto como JSON sin procesar |
Grupo de bandeja multimedia (Bin)
Comandos de gestión de la bandeja multimedia.
| Comando | Descripción |
|---|---|
import | Importar un clip a la bandeja multimedia |
remove | Eliminar un clip de la bandeja |
list | Listar todos los clips en la bandeja |
get | Obtener información detallada de un clip |
Línea de tiempo (Timeline)
Comandos de gestión de la línea de tiempo.
| Comando | Descripción |
|---|---|
add-track | Agregar una pista a la línea de tiempo |
remove-track | Eliminar una pista |
add-clip | Agregar un clip a una pista |
remove-clip | Eliminar un clip de una pista |
trim | Recortar los puntos de entrada/salida de un clip |
split | Dividir un clip en un desplazamiento temporal |
move | Mover un clip a una nueva posición |
list | Listar todas las pistas |
Grupo de filtros (Filter Group)
Comandos de gestión de filtros/efectos.
| Comando | Descripción |
|---|---|
add | Agregar un filtro a un clip |
remove | Eliminar un filtro de un clip |
set | Establecer un parámetro de filtro |
list | Listar filtros en un clip |
available | Listar todos los filtros disponibles |
Transición
Comandos de gestión de transiciones.
| Comando | Descripción |
|---|---|
add | Agregar una transición entre pistas |
remove | Eliminar una transición |
set | Establecer un parámetro de transición |
list | Listar todas las transiciones |
Guía
Comandos de gestión de guías/marcadores.
| Comando | Descripción |
|---|---|
add | Agregar una guía en una posición (segundos) |
remove | Eliminar una guía |
list | Listar todas las guías |
Exportación
Comandos de exportación y renderizado.
| Comando | Descripción |
|---|---|
xml | Generar XML de Kdenlive/MLT |
presets | Listar ajustes preestablecidos de renderizado disponibles |
Sesión
Comandos de gestión de sesión.
| Comando | Descripción |
|---|---|
status | Mostrar el estado de la sesión |
undo | Deshacer la última operación |
redo | Rehacer la última operación deshecha |
history | Mostrar el historial de deshacer |
Ejemplos
Crear un nuevo proyecto
Crear un nuevo archivo de proyecto de kdenlive.
cli-anything-kdenlive project new -o myproject.json
# O con salida JSON para uso programático
cli-anything-kdenlive --json project new -o myproject.json
Sesión REPL interactiva
Iniciar una sesión interactiva con soporte de deshacer/rehacer.
cli-anything-kdenlive
# Introduce comandos de forma interactiva
# Usa 'help' para ver los comandos disponibles
# Usa 'undo' y 'redo' para navegar por el historial
Exportar proyecto
Exportar el proyecto a un formato de salida final.
cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite
Gestión de estado
El CLI mantiene el estado de la sesión con:
- Deshacer/Rehacer: Hasta 50 niveles de historial
- Persistencia de proyecto: Guardar/cargar el estado del proyecto como JSON
- Seguimiento de sesión: Registrar modificaciones y cambios
Formatos de salida
Todos los comandos admiten dos modos de salida:
- Legible por humanos (predeterminado): Tablas, colores, texto formateado
- Legible por máquina (bandera
--json): JSON estructurado para consumo por agentes
# Salida para humanos
cli-anything-kdenlive project info -p project.json
# Salida JSON para agentes
cli-anything-kdenlive --json project info -p project.json
Para agentes de IA
Al usar este CLI de forma programática:
- Siempre usa la bandera
--jsonpara obtener salida analizable - Verifica los códigos de retorno - 0 para éxito, distinto de cero para errores
- Analiza stderr para mensajes de error en caso de fallo
- Usa rutas absolutas para todas las operaciones con archivos
- Verifica que las salidas existen después de las operaciones de exportación
Más información
- Documentación completa: Consulta README.md en el paquete
- Cobertura de pruebas: Consulta TEST.md en el paquete
- Metodología: Consulta HARNESS.md en cli-anything-plugin
Versión
1.0.0