코딩 에이전트가 로컬에서 영상 편집을 끝까지 처리하게 하는 도구
클라우드 업로드나 API 키 없이 내 컴퓨터에서 영상 편집을 끝까지 처리하는 환경을 만듭니다. 코딩 에이전트가 FFmpeg 명령을 직접 실행하고 결과물을 스스로 검증하는 워크플로우를 제공합니다. 영상 편집을 자동화하고 싶지만 데이터 보안이 중요한 개발자와 크리에이터에게 적합합니다.
측정부터 검증까지의 편집 흐름
이 도구는 에이전트가 영상 파일을 다루는 일련의 과정을 표준화합니다. 먼저 probe.py로 파일의 길이, 프레임 속도, 해상도, 오디오 구성을 측정합니다. 이후 필요한 편집 작업을 수행하고, 결과가 의도대로 나왔는지 check.py와 look.py로 검증합니다. 모든 작업은 로컬에서 이루어지며, 영상 파일이 외부 서버로 전송되지 않습니다. 에이전트는 파일 이름이 아닌 실제 측정된 데이터에 기반해 다음 단계를 결정합니다.
42가지 도구와 플랫폼별 템플릿
영상 편집에 필요한 42가지 Python 스크립트가 포함되어 있습니다.
- 자막 및 카라오케 음성 인식 엔진을 이용해 자막을 생성하거나, 기존 텍스트 파일을 영상에 입힙니다. 카라오케 스타일 애니메이션도 지원합니다.
- 오디오 처리 무음 구간을 자동으로 제거하거나, 특정 라우드니스 수준으로 오디오를 정규화합니다. 드롭아웃이나 노이즈 제거 기능도 포함됩니다.
- 화면 구성 세로형 영상으로 변환하거나, 특정 구간을 잘라내어 원하는 길이로 맞춥니다. 멀티캠 편집과 전환 효과도 지원합니다.
설치 및 요구 사항
시스템에 ffmpeg와 python3이 설치되어 있어야 합니다. npx ffmpeg-skill 명령으로 도구를 설치하고, npx ffmpeg-skill doctor로 시스템 상태를 확인합니다. 음성 인식 기반 자막 생성을 사용하려면 faster-whisper 또는 parakeet-mlx 같은 로컬 음성 엔진을 추가로 설치해야 합니다. 이 엔진들은 첫 실행 시 모델 파일을 다운로드하지만, 이후에는 로컬에서 작동합니다. Windows 환경에서는 Git Bash 사용 시 Python 경로 설정에 주의해야 합니다.
에이전트의 판단 범위와 한계
이 도구는 편집 판단을 내리지 않습니다. 어디를 자를지, 어떤 자막이 좋은지, 어떤 장면이 흥미로운지는 사용자의 지시나 다른 에이전트의 판단에 의존합니다. look.py가 생성하는 컨택트 시트는 에이전트가 결과를 시각적으로 확인하기 위한 자료일 뿐, 얼굴이나 객체를 자동으로 인식하지 않습니다. 따라서 중요한 편집 결정은 사람이 최종 검토해야 합니다. 또한 특정 FFmpeg 필터나 인코더가 시스템에 없으면 일부 기능이 제한될 수 있으므로, doctor 명령의 결과를 꼼꼼히 확인하는 것이 좋습니다.