cli-anything-openscreen

¿Qué hace cli-anything-openscreen?

Una interfaz de línea de comandos con estado para editar grabaciones de pantalla. Transforma capturas brutas en vídeos de demostración pulidos con efectos de zoom, ajustes de velocidad, recortes, anotaciones y fondos atractivos.

Instalación

pip install cli-anything-openscreen

Requisitos previos:

• Python 3.10+
• ffmpeg debe estar instalado en tu sistema

Uso

Comandos básicos

cli-anything-openscreen --help
cli-anything-openscreen                     # Modo REPL
cli-anything-openscreen project new -v recording.mp4 -o project.openscreen
cli-anything-openscreen --json project info

Modo REPL

Ejecuta cli-anything-openscreen sin argumentos para entrar en el modo interactivo. Escribe help para ver los comandos disponibles, quit para salir.

Grupos de comandos

project

Crear, abrir, guardar y configurar proyectos.

Comando	Descripción
project new [-v VIDEO] [-o PATH]	Crear nuevo proyecto con vídeo opcional
project open <path>	Abrir proyecto .openscreen existente
project save [-o PATH]	Guardar proyecto en archivo
project info	Mostrar metadatos del proyecto y conteo de regiones
project set-video <path>	Establecer archivo de vídeo fuente
project set <key> <value>	Establecer configuración del editor (padding, wallpaper, etc.)

zoom

Gestionar regiones de zoom: efectos de zoom suaves en áreas específicas de la línea de tiempo.

Comando	Descripción
zoom list	Listar todas las regiones de zoom
zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1]	Añadir zoom
zoom remove <id>	Eliminar región de zoom

Profundidades de zoom: 1=1.25x, 2=1.5x, 3=1.8x, 4=2.2x, 5=3.5x, 6=5.0x

speed

Gestionar regiones de velocidad: acelerar tiempos de inactividad, ralentizar momentos importantes.

Comando	Descripción
speed list	Listar todas las regiones de velocidad
speed add --start MS --end MS [--speed 0.25-2.0]	Añadir cambio de velocidad
speed remove <id>	Eliminar región de velocidad

Velocidades válidas: 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, 2.0

trim

Gestionar regiones de recorte: cortar secciones de la grabación.

Comando	Descripción
trim list	Listar todas las regiones de recorte
trim add --start MS --end MS	Cortar una sección
trim remove <id>	Eliminar región de recorte

crop

Establecer el área visible de la grabación.

Comando	Descripción
crop get	Mostrar región de recorte actual
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1	Establecer recorte (normalizado)

annotation

Añadir superposiciones de texto a la grabación.

Comando	Descripción
annotation list	Listar todas las anotaciones
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1]	Añadir texto
annotation remove <id>	Eliminar anotación

media

Inspeccionar y validar archivos multimedia.

Comando	Descripción
media probe <path>	Mostrar metadatos del vídeo (resolución, duración, códec)
media check <path>	Validar un archivo de vídeo
media thumbnail <input> <output> [-t TIME]	Extraer un fotograma

export

Renderizar el vídeo final pulido.

Comando	Descripción
export presets	Listar ajustes predefinidos de exportación
export render <output_path>	Renderizar proyecto a archivo de vídeo

preview

Capturar paquetes de revisión fieles del proyecto Openscreen actual.

Comando	Descripción
preview recipes	Listar recetas de previsualización disponibles
preview capture --recipe quick	Renderizar un paquete de previsualización de baja resolución
preview latest [--recipe quick]	Devolver el paquete existente más reciente

El soporte actual de previsualización es estático, no en vivo. Un paquete quick normalmente contiene:

• un clip de previsualización de baja resolución
• fotogramas muestreados
• un fotograma hero para inspección rápida
• summary.json con datos de recorte, zoom y velocidad

La captura del paquete también escribe o actualiza un archivo trajectory.json a nivel de receta junto a la raíz de previsualización, para que los agentes puedan reconstruir el historial de previsualizaciones a lo largo del tiempo.

Comandos de visualización:

cli-hub previews inspect /path/to/bundle
cli-hub previews html /path/to/bundle -o page.html
cli-hub previews open /path/to/bundle

session

Gestionar el estado de la sesión con deshacer/rehacer.

Comando	Descripción
session status	Mostrar información de la sesión
session undo	Deshacer la última operación
session redo	Rehacer la última operación deshecha
session save	Guardar el estado de la sesión en disco
session list	Listar todas las sesiones guardadas

Gestión de estado

• Deshacer/Rehacer: Hasta 50 niveles de historial de deshacer
• Persistencia de proyecto: Archivos JSON .openscreen
• Seguimiento de sesión: rastrea automáticamente las modificaciones

Formatos de salida

• Legible por humanos (predeterminado): Pares clave-valor formateados
• Legible por máquina (--json): Salida JSON estructurada

Configuraciones del editor

Configuración	Tipo	Predeterminado	Descripción
aspectRatio	string	"16:9"	16:9, 9:16, 1:1, 4:3, 4:5
wallpaper	string	"gradient_dark"	Fondo predefinido
padding	int	50	0-100, relleno alrededor del vídeo
borderRadius	int	12	Radio de esquina en píxeles
shadowIntensity	float	0	0-1, intensidad de sombra
motionBlurAmount	float	0	0-1, desenfoque de movimiento durante el zoom
exportQuality	string	"good"	medium, good, source
exportFormat	string	"mp4"	mp4, gif

Para agentes de IA

1. Siempre usa --json para salida analizable
2. Verifica los códigos de retorno: 0 = éxito, distinto de cero = error
3. Analiza stderr para mensajes de error en modo no JSON
4. Usa rutas de archivo absolutas
5. Después de export render, verifica que la salida exista y analízala
6. Los tiempos están en milisegundos para todos los comandos de región
7. Las coordenadas (foco, recorte, posición) están normalizadas 0-1
8. Usa preview capture --json para validar zoom, recorte, anotación y tiempo visualmente
9. Lee las rutas de los artefactos del paquete devueltos desde la carga JSON; las imágenes y los clips están en disco
10. Usa cli-hub previews ... solo para inspeccionar/abrir paquetes existentes

Versión

1.0.0