cli-anything-kdenlive은(는) 무엇을 하나요?
Blender CLI 하네스와 동일한 패턴을 따르는, 비디오 편집을 위한 상태 저장 명령줄 인터페이스입니다. Kdenlive/melt용 MLT XML 생성을 위해 JSON 프로젝트 형식을 사용합니다.
설치
이 CLI는 cli-anything-kdenlive 패키지의 일부로 설치됩니다:
pip install cli-anything-kdenlive
전제 조건:
- Python 3.10+
- 시스템에 kdenlive가 설치되어 있어야 함
사용법
기본 명령어
# 도움말 표시
cli-anything-kdenlive --help
# 대화형 REPL 모드 시작
cli-anything-kdenlive
# 새 프로젝트 생성
cli-anything-kdenlive project new -o project.json
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-kdenlive --json project info -p project.json
REPL 모드
하위 명령어 없이 호출하면 CLI는 대화형 REPL 세션을 시작합니다:
cli-anything-kdenlive
# 탭 완성 및 기록 기능을 사용하여 명령어를 대화형으로 입력
명령어 그룹
프로젝트
프로젝트 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
new | 새 프로젝트 생성 |
open | 기존 프로젝트 열기 |
save | 현재 프로젝트 저장 |
info | 프로젝트 정보 표시 |
profiles | 사용 가능한 비디오 프로필 나열 |
json | 원시 프로젝트 JSON 출력 |
빈 그룹
미디어 빈 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
import | 미디어 빈에 클립 가져오기 |
remove | 빈에서 클립 제거 |
list | 빈의 모든 클립 나열 |
get | 자세한 클립 정보 가져오기 |
타임라인
타임라인 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add-track | 타임라인에 트랙 추가 |
remove-track | 트랙 제거 |
add-clip | 트랙에 클립 추가 |
remove-clip | 트랙에서 클립 제거 |
trim | 클립의 시작/끝 지점 트리밍 |
split | 특정 시간 오프셋에서 클립 분할 |
move | 클립을 새 위치로 이동 |
list | 모든 트랙 나열 |
필터 그룹
필터/효과 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 클립에 필터 추가 |
remove | 클립에서 필터 제거 |
set | 필터 매개변수 설정 |
list | 클립의 필터 나열 |
available | 사용 가능한 모든 필터 나열 |
전환
전환 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 트랙 간 전환 추가 |
remove | 전환 제거 |
set | 전환 매개변수 설정 |
list | 모든 전환 나열 |
가이드
가이드/마커 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 위치(초)에 가이드 추가 |
remove | 가이드 제거 |
list | 모든 가이드 나열 |
내보내기
내보내기 및 렌더링 명령어입니다.
| 명령어 | 설명 |
|---|---|
xml | Kdenlive/MLT XML 생성 |
presets | 사용 가능한 렌더 프리셋 나열 |
세션
세션 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
status | 세션 상태 표시 |
undo | 마지막 작업 실행 취소 |
redo | 마지막으로 취소한 작업 다시 실행 |
history | 실행 취소 기록 표시 |
예제
새 프로젝트 생성
새 kdenlive 프로젝트 파일을 생성합니다.
cli-anything-kdenlive project new -o myproject.json
# 또는 프로그래밍 방식 사용을 위해 JSON 출력
cli-anything-kdenlive --json project new -o myproject.json
대화형 REPL 세션
실행 취소/다시 실행을 지원하는 대화형 세션을 시작합니다.
cli-anything-kdenlive
# 명령어를 대화형으로 입력
# 'help'를 사용하여 사용 가능한 명령어 확인
# 'undo' 및 'redo'로 기록 탐색
프로젝트 내보내기
최종 출력 형식으로 프로젝트를 내보냅니다.
cli-anything-kdenlive --project myproject.json export render output.pdf --overwrite
상태 관리
CLI는 다음을 통해 세션 상태를 유지 관리합니다:
- 실행 취소/다시 실행: 최대 50단계의 기록
- 프로젝트 영속성: JSON으로 프로젝트 상태 저장/로드
- 세션 추적: 수정 및 변경 사항 추적
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽을 수 있음 (기본값): 테이블, 색상, 서식이 지정된 텍스트
- 기계가 읽을 수 있음 (
--json플래그): 에이전트 소비를 위한 구조화된 JSON
# 사람 출력
cli-anything-kdenlive project info -p project.json
# 에이전트용 JSON 출력
cli-anything-kdenlive --json project info -p project.json
AI 에이전트용
이 CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그를 사용하여 구문 분석 가능한 출력을 얻으세요. - 반환 코드를 확인하세요 - 0은 성공, 0이 아니면 오류입니다.
- stderr를 파싱하여 오류 시 오류 메시지를 확인하세요.
- 절대 경로를 모든 파일 작업에 사용하세요.
- 내보내기 작업 후 출력이 존재하는지 확인하세요.
추가 정보
- 전체 문서: 패키지의 README.md 참조
- 테스트 범위: 패키지의 TEST.md 참조
- 방법론: cli-anything-plugin의 HARNESS.md 참조
버전
1.0.0