O que cli-anything-kdenlive faz?
Uma interface de linha de comando com estado para edição de vídeo, seguindo os mesmos padrões do harness CLI do Blender. Utiliza um formato de projeto JSON com geração de XML MLT para Kdenlive/melt.
Instalação
Esta CLI é instalada como parte do pacote cli-anything-kdenlive:
pip install cli-anything-kdenlive
Pré-requisitos:
- Python 3.10+
- kdenlive deve estar instalado no seu sistema
Uso
Comandos Básicos
# Mostrar ajuda
cli-anything-kdenlive --help
# Iniciar modo REPL interativo
cli-anything-kdenlive
# Criar um novo projeto
cli-anything-kdenlive project new -o project.json
# Executar com saída JSON (para consumo por agentes)
cli-anything-kdenlive --json project info -p project.json
Modo REPL
Quando invocado sem um subcomando, a CLI entra em uma sessão REPL interativa:
cli-anything-kdenlive
# Insira comandos interativamente com tab-completion e histórico
Grupos de Comandos
Projeto
Comandos de gerenciamento de projeto.
| Comando | Descrição |
|---|---|
new | Criar um novo projeto |
open | Abrir um projeto existente |
save | Salvar o projeto atual |
info | Mostrar informações do projeto |
profiles | Listar perfis de vídeo disponíveis |
json | Imprimir o JSON bruto do projeto |
Grupo Bin
Comandos de gerenciamento do media bin.
| Comando | Descrição |
|---|---|
import | Importar um clipe para o media bin |
remove | Remover um clipe do bin |
list | Listar todos os clipes no bin |
get | Obter informações detalhadas do clipe |
Timeline
Comandos de gerenciamento da timeline.
| Comando | Descrição |
|---|---|
add-track | Adicionar uma faixa à timeline |
remove-track | Remover uma faixa |
add-clip | Adicionar um clipe a uma faixa |
remove-clip | Remover um clipe de uma faixa |
trim | Aparar os pontos de entrada/saída de um clipe |
split | Dividir um clipe em um deslocamento de tempo |
move | Mover um clipe para uma nova posição |
list | Listar todas as faixas |
Grupo Filtro
Comandos de gerenciamento de filtros/efeitos.
| Comando | Descrição |
|---|---|
add | Adicionar um filtro a um clipe |
remove | Remover um filtro de um clipe |
set | Definir um parâmetro de filtro |
list | Listar filtros em um clipe |
available | Listar todos os filtros disponíveis |
Transição
Comandos de gerenciamento de transições.
| Comando | Descrição |
|---|---|
add | Adicionar uma transição entre faixas |
remove | Remover uma transição |
set | Definir um parâmetro de transição |
list | Listar todas as transições |
Guia
Comandos de gerenciamento de guias/marcadores.
| Comando | Descrição |
|---|---|
add | Adicionar uma guia em uma posição (segundos) |
remove | Remover uma guia |
list | Listar todas as guias |
Exportar
Comandos de exportação e renderização.
| Comando | Descrição |
|---|---|
xml | Gerar XML Kdenlive/MLT |
presets | Listar predefinições de renderização disponíveis |
Sessão
Comandos de gerenciamento de sessão.
| Comando | Descrição |
|---|---|
status | Mostrar status da sessão |
undo | Desfazer a última operação |
redo | Refazer a última operação desfeita |
history | Mostrar histórico de desfazer |
Exemplos
Criar um Novo Projeto
Criar um novo arquivo de projeto kdenlive.
cli-anything-kdenlive project new -o meusprojeto.json
# Ou com saída JSON para uso programático
cli-anything-kdenlive --json project new -o meusprojeto.json
Sessão REPL Interativa
Iniciar uma sessão interativa com suporte a desfazer/refazer.
cli-anything-kdenlive
# Insira comandos interativamente
# Use 'help' para ver comandos disponíveis
# Use 'undo' e 'redo' para navegar no histórico
Exportar Projeto
Exportar o projeto para um formato de saída final.
cli-anything-kdenlive --project meusprojeto.json export render output.pdf --overwrite
Gerenciamento de Estado
A CLI mantém o estado da sessão com:
- Desfazer/Refazer: Até 50 níveis de histórico
- Persistência de projeto: Salvar/carregar estado do projeto como JSON
- Rastreamento de sessão: Rastrear modificações e mudanças
Formatos de Saída
Todos os comandos suportam modos de saída dupla:
- Legível para humanos (padrão): Tabelas, cores, texto formatado
- Legível para máquina (flag
--json): JSON estruturado para consumo por agentes
# Saída humana
cli-anything-kdenlive project info -p project.json
# Saída JSON para agentes
cli-anything-kdenlive --json project info -p project.json
Para Agentes de IA
Ao usar esta CLI programaticamente:
- Sempre use a flag
--jsonpara saída parseável - Verifique os códigos de retorno - 0 para sucesso, não-zero para erros
- Analise o stderr para mensagens de erro em caso de falha
- Use caminhos absolutos para todas as operações de arquivo
- Verifique se as saídas existem após operações de exportação
Mais Informações
- Documentação completa: Veja README.md no pacote
- Cobertura de testes: Veja TEST.md no pacote
- Metodologia: Veja HARNESS.md no cli-anything-plugin
Versão
1.0.0