cli-anything-obs_studio
Una interfaz de línea de comandos con estado para editar colecciones de escenas de OBS Studio, siguiendo los mismos patrones que el CLI de Blender. Utiliza un formato JSON de colección de escenas. No requiere instalación de OBS para la edición.
Instalación
Este CLI se instala como parte del paquete cli-anything-obs_studio:
pip install cli-anything-obs_studio
Requisitos previos:
- Python 3.10+
- obs_studio debe estar instalado en tu sistema
Uso
Comandos Básicos
# Mostrar ayuda
cli-anything-obs_studio --help
# Iniciar modo REPL interactivo
cli-anything-obs_studio
# Crear un nuevo proyecto
cli-anything-obs_studio project new -o project.json
# Ejecutar con salida JSON (para consumo de agentes)
cli-anything-obs_studio --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-obs_studio
# Introduce comandos interactivamente con autocompletado e historial
Grupos de Comandos
Proyecto
Comandos de gestión de proyectos.
| Comando | Descripción |
|---|---|
new | Crear una nueva colección de escenas de OBS |
open | Abrir un proyecto existente |
save | Guardar el proyecto actual |
info | Mostrar información del proyecto |
json | Imprimir el JSON del proyecto en bruto |
Escena
Comandos de gestión de escenas.
| Comando | Descripción |
|---|---|
add | Añadir una nueva escena |
remove | Eliminar una escena por índice |
duplicate | Duplicar una escena |
set-active | Establecer la escena activa |
list | Listar todas las escenas |
Fuente
Comandos de gestión de fuentes.
| Comando | Descripción |
|---|---|
add | Añadir una fuente a una escena |
remove | Eliminar una fuente por índice |
duplicate | Duplicar una fuente |
set | Establecer una propiedad de la fuente (nombre, visible, bloqueado, opacidad, rotación) |
transform | Transformar una fuente (posición, tamaño, recorte, rotación) |
list | Listar todas las fuentes en una escena |
Filtro
Comandos de gestión de filtros.
| Comando | Descripción |
|---|---|
add | Añadir un filtro a una fuente |
remove | Eliminar un filtro de una fuente |
set | Establecer un parámetro de filtro |
list | Listar todos los filtros en una fuente |
list-available | Listar todos los tipos de filtro disponibles |
Audio
Comandos de gestión de audio.
| Comando | Descripción |
|---|---|
add | Añadir una fuente de audio global |
remove | Eliminar una fuente de audio global |
volume | Establecer el volumen de una fuente de audio (0.0-3.0) |
mute | Silenciar una fuente de audio |
unmute | Reactivar el sonido de una fuente de audio |
monitor | Establecer el tipo de monitorización de audio |
list | Listar todas las fuentes de audio |
Transición
Comandos de gestión de transiciones.
| Comando | Descripción |
|---|---|
add | Añadir una transición |
remove | Eliminar una transición |
set-active | Establecer la transición activa |
duration | Establecer la duración de la transición en milisegundos |
list | Listar todas las transiciones |
Salida
Configuración de salida/streaming/grabación.
| Comando | Descripción |
|---|---|
streaming | Configurar ajustes de streaming |
recording | Configurar ajustes de grabación |
settings | Configurar ajustes de salida |
info | Mostrar la configuración de salida actual |
presets | Listar los preajustes de codificación 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 obs_studio.
cli-anything-obs_studio project new -o myproject.json
# O con salida JSON para uso programático
cli-anything-obs_studio --json project new -o myproject.json
Sesión REPL Interactiva
Iniciar una sesión interactiva con soporte para deshacer/rehacer.
cli-anything-obs_studio
# Introduce comandos interactivamente
# Usa 'help' para ver los comandos disponibles
# Usa 'undo' y 'redo' para la navegación del historial
Gestión de Estado
El CLI mantiene el estado de la sesión con:
- Deshacer/Rehacer: Hasta 50 niveles de historial
- Persistencia de proyectos: Guardar/cargar el estado del proyecto como JSON
- Seguimiento de sesión: Rastrear modificaciones y cambios
Formatos de Salida
Todos los comandos soportan dos modos de salida:
- Legible por humanos (por defecto): Tablas, colores, texto formateado
- Legible por máquina (bandera
--json): JSON estructurado para consumo de agentes
# Salida humana
cli-anything-obs_studio project info -p project.json
# Salida JSON para agentes
cli-anything-obs_studio --json project info -p project.json
Para Agentes de IA
Al usar este CLI de forma programática:
- Usa siempre 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