cli-anything-openscreen은(는) 무엇을 하나요?
화면 녹화 편집을 위한 상태 저장형 명령줄 인터페이스입니다. 확대 효과, 속도 조절, 트리밍, 주석 및 아름다운 배경을 사용하여 원본 캡처를 세련된 데모 비디오로 변환합니다.
설치
pip install cli-anything-openscreen
필수 조건:
- Python 3.10+
- 시스템에 ffmpeg가 설치되어 있어야 함
사용법
기본 명령어
cli-anything-openscreen --help
cli-anything-openscreen # REPL 모드
cli-anything-openscreen project new -v recording.mp4 -o project.openscreen
cli-anything-openscreen --json project info
REPL 모드
cli-anything-openscreen을 인수 없이 실행하여 대화형 모드로 진입하세요. help를 입력하면 사용 가능한 명령어를, quit를 입력하면 종료합니다.
명령어 그룹
project
프로젝트 생성, 열기, 저장 및 설정을 관리합니다.
| 명령어 | 설명 |
|---|---|
project new [-v VIDEO] [-o PATH] | 새 프로젝트 생성 (비디오 파일 선택 가능) |
project open <path> | 기존 .openscreen 프로젝트 열기 |
project save [-o PATH] | 프로젝트를 파일로 저장 |
project info | 프로젝트 메타데이터 및 영역 수 표시 |
project set-video <path> | 원본 비디오 파일 설정 |
project set <key> <value> | 편집기 설정 변경 (여백, 배경 등) |
zoom
확대 영역을 관리합니다 — 타임라인의 특정 구간에 부드러운 확대 효과를 적용합니다.
| 명령어 | 설명 |
|---|---|
zoom list | 모든 확대 영역 나열 |
zoom add --start MS --end MS [--depth 1-6] [--focus-x 0-1] [--focus-y 0-1] | 확대 추가 |
zoom remove <id> | 확대 영역 제거 |
확대 깊이: 1=1.25배, 2=1.5배, 3=1.8배, 4=2.2배, 5=3.5배, 6=5.0배
speed
속도 영역을 관리합니다 — 유휴 시간은 빠르게, 중요한 순간은 느리게 조절합니다.
| 명령어 | 설명 |
|---|---|
speed list | 모든 속도 영역 나열 |
speed add --start MS --end MS [--speed 0.25-2.0] | 속도 변경 추가 |
speed remove <id> | 속도 영역 제거 |
유효 속도: 0.25, 0.5, 0.75, 1.25, 1.5, 1.75, 2.0
trim
트리밍 영역을 관리합니다 — 녹화의 특정 구간을 잘라냅니다.
| 명령어 | 설명 |
|---|---|
trim list | 모든 트리밍 영역 나열 |
trim add --start MS --end MS | 구간 잘라내기 |
trim remove <id> | 트리밍 영역 제거 |
crop
녹화의 표시 영역을 설정합니다.
| 명령어 | 설명 |
|---|---|
crop get | 현재 자르기 영역 표시 |
crop set --x 0-1 --y 0-1 --width 0-1 --height 0-1 | 자르기 영역 설정 (정규화) |
annotation
녹화에 텍스트 오버레이를 추가합니다.
| 명령어 | 설명 |
|---|---|
annotation list | 모든 주석 나열 |
annotation add-text --start MS --end MS --text "..." [--x 0-1] [--y 0-1] | 텍스트 추가 |
annotation remove <id> | 주석 제거 |
media
미디어 파일을 검사하고 유효성을 확인합니다.
| 명령어 | 설명 |
|---|---|
media probe <path> | 비디오 메타데이터 표시 (해상도, 길이, 코덱) |
media check <path> | 비디오 파일 유효성 검사 |
media thumbnail <input> <output> [-t TIME] | 프레임 추출 |
export
최종 완성 비디오를 렌더링합니다.
| 명령어 | 설명 |
|---|---|
export presets | 사용 가능한 내보내기 프리셋 목록 |
export render <output_path> | 프로젝트를 비디오 파일로 렌더링 |
preview
현재 Openscreen 프로젝트에서 실제 검토 번들을 캡처합니다.
| 명령어 | 설명 |
|---|---|
preview recipes | 사용 가능한 프리뷰 레시피 목록 |
preview capture --recipe quick | 저해상도 프리뷰 번들 렌더링 |
preview latest [--recipe quick] | 마지막으로 생성된 번들 반환 |
현재 프리뷰 지원은 실시간이 아닌 정적 방식입니다. quick 번들에는 일반적으로 다음이 포함됩니다:
- 저해상도 프리뷰 클립
- 샘플링된 프레임
- 빠른 검사를 위한
hero프레임 - 트림/줌/속도 정보가 포함된
summary.json
번들 캡처는 또한 프리뷰 루트 옆에 안정적인 레시피 수준의 trajectory.json을 작성하거나 업데이트하여 에이전트가 시간 경과에 따른 프리뷰 내역을 재구성할 수 있도록 합니다.
뷰어 명령어:
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
실행 취소/다시 실행 기능으로 세션 상태를 관리합니다.
| 명령어 | 설명 |
|---|---|
session status | 세션 정보 표시 |
session undo | 마지막 작업 실행 취소 |
session redo | 마지막으로 취소한 작업 다시 실행 |
session save | 세션 상태를 디스크에 저장 |
session list | 저장된 모든 세션 목록 |
상태 관리
- 실행 취소/다시 실행: 최대 50단계의 실행 취소 내역
- 프로젝트 저장: JSON
.openscreen파일 - 세션 추적: 수정 사항 자동 추적
출력 형식
- 사람이 읽을 수 있는 형식 (기본값): 형식화된 키-값 쌍
- 기계가 읽을 수 있는 형식 (
--json): 구조화된 JSON 출력
편집기 설정
| 설정 | 유형 | 기본값 | 설명 |
|---|---|---|---|
aspectRatio | string | "16:9" | 16:9, 9:16, 1:1, 4:3, 4:5 |
wallpaper | string | "gradient_dark" | 배경 프리셋 |
padding | int | 50 | 0-100, 비디오 주변 여백 |
borderRadius | int | 12 | 모서리 반경 (픽셀) |
shadowIntensity | float | 0 | 0-1, 그림자 강도 |
motionBlurAmount | float | 0 | 0-1, 줌 시 모션 블러 |
exportQuality | string | "good" | medium, good, source |
exportFormat | string | "mp4" | mp4, gif |
AI 에이전트를 위한 팁
- 파싱 가능한 출력을 위해 항상
--json을 사용하세요. - 반환 코드를 확인하세요 — 0은 성공, 0이 아닌 값은 오류입니다.
- 비-JSON 모드에서는 stderr에서 오류 메시지를 파싱하세요.
- 절대 파일 경로를 사용하세요.
export render후 출력 파일이 존재하는지 확인하고 프로브하세요.- 모든 영역 명령어의 시간은 밀리초(ms) 단위입니다.
- 좌표 (초점, 자르기, 위치)는 0-1 사이로 정규화됩니다.
preview capture --json을 사용하여 줌, 트림, 주석 및 타이밍을 시각적으로 검증하세요.- 반환된 번들 아티팩트 경로는 JSON 페이로드에서 읽으며, 이미지와 클립은 디스크에 있습니다.
cli-hub previews ...는 기존 번들을 검사하거나 열 때만 사용하세요.
버전
1.0.0