비디오 편집
자연어 명령어를 사용하여 비디오를 편집합니다. 트리밍, 점프 컷(무음 제거), 여러 스타일의 자막, 텍스트 오버레이, 속도 변경을 지원하며, 모두 ffmpeg와 Whisper를 기반으로 합니다.
사용법
비디오 파일 경로와 원하는 작업을 설명하세요:
~/video.mp4에 있는 내 비디오 편집해줘 — 무음 제거, Hormozi 스타일 자막 추가, 1.25배속
~/interview.mp4를 00:02:00부터 00:15:00까지 자르고 기본 자막 추가해줘
~/video.mp4의 1분 지점에 "Subscribe!" 텍스트 오버레이 추가해줘
기능
트리밍
특정 시작/종료 타임스탬프 또는 길이로 비디오를 자릅니다.
scripts/trim.sh video.mp4 --start 00:01:30 --end 00:05:00
점프 컷 (무음 제거)
무음/데드 에어 구간을 자동으로 감지하고 제거합니다. 임계값, 최소 무음 지속 시간, 패딩을 설정할 수 있습니다.
scripts/jumpcut.sh video.mp4 --threshold -30 --duration 0.5 --padding 0.1
자막
Whisper로 오디오를 텍스트로 변환한 후 비디오에 자막을 입힙니다. 세 가지 자막 스타일:
| 스타일 | 설명 |
|---|---|
| hormozi | 굵게, 중앙 정렬, 큰 글씨 — Alex Hormozi의 단어별 임팩트 스타일 |
| standard | 반투명 배경의 전통적인 하단 자막 |
| minimal | 작은 하단 서드 자막, 깔끔하고 눈에 거슬리지 않음 |
scripts/transcribe.sh video.mp4 --model base --language en
scripts/caption.sh video.mp4 video.srt --style hormozi
텍스트 오버레이
특정 위치와 타임스탬프에 텍스트를 추가합니다. 7가지 위치 지원: 중앙, 상단, 하단, 상단-왼쪽, 상단-오른쪽, 하단-왼쪽, 하단-오른쪽.
scripts/overlay-text.sh video.mp4 --text "Subscribe!" --start 00:01:00 --end 00:01:05 --position bottom-right
속도 변경
재생 속도를 조정합니다 (atempo를 통해 오디오 피치 보정됨).
# edit.sh 오케스트레이터를 통해
scripts/edit.sh video.mp4 --speed 1.5
전체 파이프라인 (오케스트레이터)
단일 명령어로 여러 작업을 연결합니다:
scripts/edit.sh video.mp4 \
--trim-start 00:00:10 --trim-end 00:10:00 \
--jumpcut \
--caption --caption-style hormozi \
--speed 1.25 \
--overlay-text "Like & Subscribe" --overlay-start 00:01:00 \
--output final.mp4
파이프라인 순서: 트림 → 점프 컷 → 속도 → 자막 → 오버레이
요구 사항
- ffmpeg — 비디오 처리 (설치 필요)
- whisper — 자막을 위한 오디오 텍스트 변환 (openai-whisper CLI)
스크립트 참조
| 스크립트 | 목적 |
|---|---|
scripts/edit.sh | 메인 오케스트레이터 — 모든 작업 연결 |
scripts/transcribe.sh | Whisper 텍스트 변환 → SRT 파일 |
scripts/caption.sh | SRT 자막을 비디오에 스타일과 함께 입히기 |
scripts/trim.sh | 타임스탬프로 자르기 |
scripts/jumpcut.sh | silencedetect로 자동 무음 제거 |
scripts/overlay-text.sh | 위치 지정 텍스트 오버레이 추가 |
에이전트 지침
사용자가 비디오 편집을 요청하면:
- 요청 분석 — 필요한 작업 식별 (트림, 점프 컷, 자막, 오버레이, 속도)
- 다중 작업 편집에는 edit.sh 사용 — 올바른 순서로 작업을 연결함
- 단일 작업에는 개별 스크립트 사용 — 더 빠르고 간단한 출력
- 자막: 사용자가 기존 SRT를 가지고 있으면
--caption-srt사용; 그렇지 않으면 자동으로 텍스트 변환 실행 - 기본 자막 스타일: 사용자가 스타일을 지정하지 않으면 "standard" 사용
- 기본 whisper 모델: 속도를 위해 "base" 사용; 길거나 소음이 많은 비디오의 정확성을 위해 "medium" 또는 "large" 제안
- 출력: 항상 사용자에게 출력 파일 경로와 길이를 알려줌