cli-anything-kdenlive

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

cli-anything-kdenlive

A stateful command-line interface for video editing, following the same patterns as the Blender CLI harness. Uses a JSON project format with MLT XML generation for Kdenlive/melt.

一个有状态的视频编辑命令行界面，遵循与Blender CLI工具相同的模式。采用JSON项目格式，可为Kdenlive/melt生成MLT XML。

Installation

安装

This CLI is installed as part of the cli-anything-kdenlive package:

bash

pip install cli-anything-kdenlive

Prerequisites:

Python 3.10+
kdenlive must be installed on your system

此CLI作为cli-anything-kdenlive包的一部分进行安装：

bash

pip install cli-anything-kdenlive

前置要求：

Python 3.10+
系统中必须安装kdenlive

Usage

使用方法

Basic Commands

基础命令

bash

undefined

bash

undefined

Show help

显示帮助信息

cli-anything-kdenlive --help

Start interactive REPL mode

启动交互式REPL模式

cli-anything-kdenlive

Create a new project

创建新项目

cli-anything-kdenlive project new -o project.json

Run with JSON output (for agent consumption)

以JSON格式输出（供Agent使用）

cli-anything-kdenlive --json project info -p project.json

undefined

cli-anything-kdenlive --json project info -p project.json

undefined

REPL Mode

REPL模式

When invoked without a subcommand, the CLI enters an interactive REPL session:

bash

cli-anything-kdenlive

当不指定子命令调用时，CLI会进入交互式REPL会话：

bash

cli-anything-kdenlive

Enter commands interactively with tab-completion and history

交互式输入命令，支持自动补全和历史记录

undefined

undefined

Command Groups

命令组

Project

项目

Project management commands.

Command	Description
`new`	Create a new project
`open`	Open an existing project
`save`	Save the current project
`info`	Show project information
`profiles`	List available video profiles
`json`	Print raw project JSON

项目管理命令。

命令	描述
`new`	创建新项目
`open`	打开现有项目
`save`	保存当前项目
`info`	显示项目信息
`profiles`	列出可用的视频配置文件
`json`	打印原始项目JSON

Bin Group

媒体库组

Media bin management commands.

Command	Description
`import`	Import a clip into the media bin
`remove`	Remove a clip from the bin
`list`	List all clips in the bin
`get`	Get detailed clip info

媒体库管理命令。

命令	描述
`import`	将剪辑导入媒体库
`remove`	从媒体库中移除剪辑
`list`	列出媒体库中的所有剪辑
`get`	获取剪辑详细信息

Timeline

时间线

Timeline management commands.

Command	Description
`add-track`	Add a track to the timeline
`remove-track`	Remove a track
`add-clip`	Add a clip to a track
`remove-clip`	Remove a clip from a track
`trim`	Trim a clip's in/out points
`split`	Split a clip at a time offset
`move`	Move a clip to a new position
`list`	List all tracks

时间线管理命令。

命令	描述
`add-track`	向时间线添加轨道
`remove-track`	移除轨道
`add-clip`	向轨道添加剪辑
`remove-clip`	从轨道移除剪辑
`trim`	修剪剪辑的入点/出点
`split`	在指定时间偏移处分割剪辑
`move`	将剪辑移动到新位置
`list`	列出所有轨道

Filter Group

滤镜组

Filter/effect management commands.

Command	Description
`add`	Add a filter to a clip
`remove`	Remove a filter from a clip
`set`	Set a filter parameter
`list`	List filters on a clip
`available`	List all available filters

滤镜/效果管理命令。

命令	描述
`add`	为剪辑添加滤镜
`remove`	从剪辑移除滤镜
`set`	设置滤镜参数
`list`	列出剪辑上的滤镜
`available`	列出所有可用滤镜

Transition

转场

Transition management commands.

Command	Description
`add`	Add a transition between tracks
`remove`	Remove a transition
`set`	Set a transition parameter
`list`	List all transitions

转场管理命令。

命令	描述
`add`	在轨道之间添加转场
`remove`	移除转场
`set`	设置转场参数
`list`	列出所有转场

Guide

辅助线

Guide/marker management commands.

Command	Description
`add`	Add a guide at a position (seconds)
`remove`	Remove a guide
`list`	List all guides

辅助线/标记管理命令。

命令	描述
`add`	在指定位置（秒）添加辅助线
`remove`	移除辅助线
`list`	列出所有辅助线

Export

导出

Export and render commands.

Command	Description
`xml`	Generate Kdenlive/MLT XML
`presets`	List available render presets

导出与渲染命令。

命令	描述
`xml`	生成Kdenlive/MLT XML
`presets`	列出可用的渲染预设

Session

会话

Session management commands.

Command	Description
`status`	Show session status
`undo`	Undo the last operation
`redo`	Redo the last undone operation
`history`	Show undo history

会话管理命令。

命令	描述
`status`	显示会话状态
`undo`	撤销上一次操作
`redo`	重做上一次撤销的操作
`history`	显示撤销历史

Examples

示例

Create a New Project

创建新项目

Create a new kdenlive project file.

bash

cli-anything-kdenlive project new -o myproject.json

创建一个新的kdenlive项目文件。

bash

cli-anything-kdenlive project new -o myproject.json

Or with JSON output for programmatic use

或使用JSON格式输出以用于程序化调用

cli-anything-kdenlive --json project new -o myproject.json

undefined

cli-anything-kdenlive --json project new -o myproject.json

undefined

Interactive REPL Session

交互式REPL会话

Start an interactive session with undo/redo support.

bash

cli-anything-kdenlive

启动支持撤销/重做的交互式会话。

bash

cli-anything-kdenlive

Enter commands interactively

交互式输入命令

Use 'help' to see available commands

使用'help'查看可用命令

Use 'undo' and 'redo' for history navigation

使用'undo'和'redo'导航历史记录

undefined

undefined

Export Project

导出项目

Export the project to a final output format.

bash

cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite

将项目导出为最终输出格式。

bash

cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite

State Management

状态管理

The CLI maintains session state with:

Undo/Redo: Up to 50 levels of history
Project persistence: Save/load project state as JSON
Session tracking: Track modifications and changes

CLI通过以下方式维护会话状态：

撤销/重做：最多支持50级历史记录
项目持久化：以JSON格式保存/加载项目状态
会话跟踪：跟踪修改和变更

Output Formats

输出格式

All commands support dual output modes:

Human-readable (default): Tables, colors, formatted text
Machine-readable (
```
--json
```
flag): Structured JSON for agent consumption

bash

undefined

所有命令支持两种输出模式：

人类可读格式（默认）：表格、颜色、格式化文本
机器可读格式（
```
--json
```
标志）：结构化JSON，供Agent使用

bash

undefined

Human output

人类可读输出

cli-anything-kdenlive project info -p project.json

JSON output for agents

供Agent使用的JSON输出

cli-anything-kdenlive --json project info -p project.json

undefined

cli-anything-kdenlive --json project info -p project.json

undefined

For AI Agents

面向AI Agent

When using this CLI programmatically:

Always use
--json
flag for parseable output
Check return codes - 0 for success, non-zero for errors
Parse stderr for error messages on failure
Use absolute paths for all file operations
Verify outputs exist after export operations

当以程序化方式使用此CLI时：

始终使用
--json
标志以获得可解析的输出
检查返回码 - 0表示成功，非零表示错误
解析stderr以获取失败时的错误消息
使用绝对路径进行所有文件操作
导出操作后验证输出是否存在

More Information

Version

版本

1.0.0

cli-anything-kdenlive

Original

Translation

cli-anything-kdenlive

cli-anything-kdenlive

Installation

安装

Usage

使用方法

Basic Commands

基础命令

Show help

显示帮助信息

Start interactive REPL mode

启动交互式REPL模式

Create a new project

创建新项目

Run with JSON output (for agent consumption)

以JSON格式输出（供Agent使用）

REPL Mode

REPL模式

Enter commands interactively with tab-completion and history

交互式输入命令，支持自动补全和历史记录

Command Groups

命令组

Project

项目

Bin Group

媒体库组

Timeline

时间线

Filter Group

滤镜组

Transition

转场

Guide

辅助线

Export

导出

Session

会话

Examples

示例

Create a New Project

创建新项目

Or with JSON output for programmatic use

或使用JSON格式输出以用于程序化调用

Interactive REPL Session

交互式REPL会话

Enter commands interactively

交互式输入命令

Use 'help' to see available commands

使用'help'查看可用命令

Use 'undo' and 'redo' for history navigation

使用'undo'和'redo'导航历史记录

Export Project

导出项目

State Management

状态管理

Output Formats

输出格式

Human output

人类可读输出

JSON output for agents

供Agent使用的JSON输出

For AI Agents

面向AI Agent

More Information

更多信息

Version

版本