Apple Silicon Mac에서 원본 영상을 로컬로 분석해 Final Cut Pro용 러프컷을 생성하는 오픈소스 도구입니다. Final Cut Pro나 Apple의 공식 제품이 아닙니다.
현재 단계:
v0.1.0-alpha— 단일 화자 브이로그/토킹헤드 영상과 Final Cut Pro 12, FCPXML 1.14 조합에서 우선 검증했습니다. 결과를 검토한 뒤 사용하세요.
flowchart LR
A["원본 MOV/MP4"] --> B["환경·코덱 사전 점검"]
B --> C["MLX Whisper 음성 인식"]
C --> D["무음·말버릇·반복·NG 분석"]
D --> E["단어 경계 보호 컷 결정"]
E --> F["음량·노이즈 보정"]
F --> G["Final Cut FCPXML"]
F --> H["SRT·VTT·ASS 자막"]
F --> I["검토용 MP4·HTML 리포트"]
G --> J["Final Cut에서 최종 검수·내보내기"]
- Final Cut Pro 12용 FCPXML 1.14 번들
- 무음·명백한 반복·NG를 줄인 비파괴 러프컷
- 보정 오디오 WAV와 최종 컷 기준 음량 점검
- 컷 타임라인에 정렬된 한국어 SRT/VTT/ASS
- 크기 62, 하단에서 조금 올린 편집 가능한 Final Cut Basic Title 자막
- 삭제구간 검토 프로젝트와 HTML 리포트
원본 영상은 수정하거나 덮어쓰지 않습니다. 분석과 편집은 Mac에서 로컬로 진행되며, 최초 설치 시에만 Python 패키지·Whisper 모델·FFmpeg·Pretendard를 다운로드합니다.
- Apple Silicon Mac
- macOS
- Final Cut Pro 12 권장
- Python 3.12 또는 Codex 데스크톱의 번들 Python
- 최초 설치와 Whisper 모델 다운로드를 위한 인터넷 연결
git clone https://github.com/overcomemac/fcpxml-auto-editor.git
cd fcpxml-auto-editor
./setup.sh./fcp_autoedit.sh "/절대경로/원본.MOV" --preset 보수결과는 output/에 생성됩니다. .fcpxmld를 Final Cut Pro로 가져온 다음 SRT는
파일 > 가져오기 > 캡션으로 가져옵니다. 원본 파일은 수정하지 않습니다.
주요 결과물은 다음과 같습니다.
| 결과물 | 용도 |
|---|---|
.fcpxmld |
Final Cut Pro 러프컷 프로젝트 가져오기 |
.srt, .vtt, .ass |
자막 편집·게시·번인 |
| 보정 오디오 WAV | 컷 기준 음량과 음성 보정 |
| 검토용 MP4 | Final Cut을 열기 전 빠른 결과 확인 |
| HTML 리포트 | 유지·삭제 구간과 컷 밀도 점검 |
공개 기본값은 config.json에 있습니다. 개인 설정은 config.local.json을 만들면
기본값 위에 적용되며 Git에는 커밋되지 않습니다. 첫 실사용은 보수 설정을
권장합니다.
자주 틀리는 고유명사나 단어는 glossary.json에 "오인식": "정답" 형식으로
추가하면 다음 실행부터 SRT/VTT/ASS에 자동 반영됩니다.
처음 환경을 다시 만들 때는 ./setup.sh를 실행합니다. FCPXML은 이 Mac의 Final Cut
Pro 12에 포함된 FCPXML 1.14 DTD를 기준으로 생성합니다.
setup.sh는 Pretendard가 없을 때 공식 v1.3.9 Regular·SemiBold·Bold만 설치하며,
다운로드 파일의 SHA-256도 확인합니다.
매 실행 전 preflight.py가 ffmpeg 필터, MLX Whisper, Pretendard 글꼴과 Final Cut
DTD를 점검합니다. 결과 FCPXML도 생성 직후 DTD로 다시 검증되어 잘못된 프로젝트가
Final Cut에 전달되지 않도록 중단합니다.
- Final Cut 가져오기, 사용자의 최종 검수와 내보내기는 아직 수동입니다.
- YouTube 업로드 기능은 아직 포함하지 않습니다.
- 멀티캠, B-roll 자동 배치와 음악 편집은 실험 단계입니다.
- 공격적인 프리셋은 정상 발화까지 제거할 수 있으므로 리포트 검토가 필요합니다.
- 다른 Final Cut/FCPXML 버전과 Intel Mac은 아직 보장하지 않습니다.
v0.2: 1080p·4K 업로드용 최종 MP4 렌더 프리셋v0.3: 사용자 OAuth 기반 YouTube 비공개 업로드v0.4: Final Cut/FCPXML 버전 자동 감지 확대v1.0: 반복 검증용 공개 샘플과 안정화된 프리셋
변경 내역은 CHANGELOG.md에서 확인할 수 있습니다.
이 프로젝트는 MIT 라이선스인
Premiere-Pro-edit-bibl을
기반으로 Final Cut Pro/FCPXML 워크플로에 맞게 수정했습니다. 원저작권 고지와
변경 내역은 LICENSE와 NOTICE.md를 확인하세요.