비디오 프로세서은(는) 무엇을 하나요?
지침
이 스킬은 FFmpeg와 OpenAI의 Whisper 모델을 사용하여 오디오 추출, 포맷 변환, 그리고 오디오 텍스트 변환을 포함한 비디오 처리 유틸리티를 제공합니다.
사전 요구 사항
필수 도구 (환경에 설치되어 있어야 함):
-
FFmpeg: 비디오/오디오 처리를 위한 멀티미디어 프레임워크
# macOS brew install ffmpeg # Ubuntu/Debian apt-get install ffmpeg # 설치 확인 ffmpeg -version -
OpenAI Whisper: 음성을 텍스트로 변환하는 모델
# pip를 통해 설치 pip install -U openai-whisper # 설치 확인 whisper --help
Python 패키지 (PEP 723을 통해 스크립트에 포함):
- click (CLI 프레임워크)
- ffmpeg-python (FFmpeg용 Python 래퍼)
워크플로
모든 비디오 처리 작업에는 scripts/video_processor.py 스크립트를 사용하십시오. 이 스크립트는 다음과 같은 명령어가 포함된 간단한 CLI를 제공합니다.
1. 비디오에서 오디오 추출
비디오 파일에서 오디오 트랙을 추출합니다:
uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio input.mp4 output.wav
옵션:
--format: 출력 오디오 포맷 (기본값: wav). 지원 포맷: wav, mp3, aac, flac- 출력은 텍스트 변환 또는 독립형 오디오 사용에 적합합니다.
2. 비디오를 MP4로 변환
모든 비디오 파일을 MP4 포맷으로 변환합니다:
uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 input.avi output.mp4
옵션:
--codec: 비디오 코덱 (기본값: libx264). 일반적인 옵션: libx264, libx265, h264--preset: 인코딩 속도/품질 사전 설정 (기본값: medium). 옵션: ultrafast, fast, medium, slow, veryslow
3. 비디오를 WebM으로 변환
모든 비디오 파일을 WebM 포맷(웹 최적화)으로 변환합니다:
uv run .claude/skills/video-processor/scripts/video_processor.py to-webm input.mp4 output.webm
옵션:
--codec: 비디오 코덱 (기본값: libvpx-vp9). 옵션: libvpx, libvpx-vp9- WebM은 웹 재생 및 스트리밍에 최적화되어 있습니다.
4. Whisper로 오디오 텍스트 변환
OpenAI의 Whisper 모델을 사용하여 오디오 또는 비디오 파일을 텍스트로 변환합니다:
# 비디오 파일 텍스트 변환 (오디오는 자동으로 추출됨)
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe input.mp4 transcript.txt
# 오디오 파일 직접 텍스트 변환
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe audio.wav transcript.txt
옵션:
--model: Whisper 모델 크기 (기본값: base). 옵션:tiny: 가장 빠름, 가장 낮은 정확도 (~1GB RAM)base: 빠름, 좋은 정확도 (~1GB RAM) [기본값]small: 균형 잡힘 (~2GB RAM)medium: 높은 정확도 (~5GB RAM)large: 최고 정확도, 가장 느림 (~10GB RAM)
--language: 언어 코드 (기본값: 자동 감지). 예: en, es, fr, de, zh--format: 출력 포맷 (기본값: txt). 옵션: txt, srt, vtt, json
텍스트 변환 워크플로:
- 입력이 비디오인 경우 FFmpeg가 오디오를 임시 WAV 파일로 추출합니다.
- Whisper가 오디오 파일을 처리합니다.
- 텍스트 변환 결과가 요청된 포맷으로 저장됩니다.
- 임시 파일은 자동으로 정리됩니다.
5. 통합 워크플로 예제
비디오를 처음부터 끝까지 처리합니다:
# 1. 분석을 위해 오디오 추출
uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav
# 2. SRT 자막으로 텍스트 변환
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 lecture.srt --format srt --model small
# 3. 웹 포맷으로 변환
uv run .claude/skills/video-processor/scripts/video_processor.py to-webm lecture.mp4 lecture.webm
주요 기술 세부 사항
FFmpeg와 Whisper 통합:
- FFmpeg는 자체적으로 오디오를 텍스트로 변환하지 않습니다. 외부 텍스트 변환을 위해 오디오를 준비합니다.
- 워크플로는 다음과 같습니다: 오디오 추출(FFmpeg) → 텍스트 변환(Whisper) → 선택 사항: 비디오와 재통합
- FFmpeg는 실시간 처리를 위해 오디오를 Whisper로 직접 파이프할 수 있습니다(고급 사용 사례).
텍스트 변환을 위한 오디오 포맷:
- Whisper는 WAV 또는 MP3 포맷에서 가장 잘 작동합니다.
- 샘플 속도: 16kHz가 최적입니다(스크립트가 자동으로 변환 처리).
- 스크립트는 Whisper에 최적화된 설정으로 오디오를 추출합니다.
출력 포맷:
- txt: 일반 텍스트 변환
- srt: SubRip 자막 포맷 (타임스탬프 포함)
- vtt: WebVTT 자막 포맷 (웹 표준)
- json: 단어 수준 타임스탬프가 포함된 상세 JSON
오류 처리
스크립트는 포괄적인 오류 처리를 포함합니다:
- 입력 파일이 존재하는지 확인합니다.
- FFmpeg와 Whisper가 설치되어 있는지 확인합니다.
- 누락된 종속성에 대한 명확한 오류 메시지를 제공합니다.
- 오류 발생 시 임시 파일 정리를 처리합니다.
성능 팁
- 빠른 초안을 위해
tiny또는base모델을 사용하세요. - 프로덕션 텍스트 변환을 위해
small또는medium을 사용하세요. - 최대 정확도가 필요할 때만
large를 사용하세요. - 긴 비디오의 경우 먼저 오디오를 추출한 다음 세그먼트별로 텍스트 변환하는 것을 고려하세요.
- VP9을 사용한 WebM 변환은 시간이 더 오래 걸리지만 더 작은 파일을 생성합니다.
예제
예제 1: 빠른 비디오를 MP4로 변환
사용자 요청:
오래된 카메라에서 찍은 AVI 파일이 있는데 MP4로 변환할 수 있나요?
수행할 작업:
- 기본 설정으로 to-mp4 명령어를 사용하세요:
uv run .claude/skills/video-processor/scripts/video_processor.py to-mp4 old_video.avi output.mp4 - 변환이 성공적으로 완료되었는지 확인하세요.
- 출력 파일 위치를 사용자에게 알려주세요.
예제 2: 오디오 추출 및 텍스트 변환
사용자 요청:
강의 비디오를 녹화했는데 텍스트 변환이 필요해요. 오디오를 추출하고 텍스트로 변환해줄 수 있나요?
수행할 작업:
- 먼저 오디오를 추출하세요:
uv run .claude/skills/video-processor/scripts/video_processor.py extract-audio lecture.mp4 lecture.wav - 그런 다음 base 모델을 사용하여 텍스트 변환하세요(속도/정확도의 좋은 균형):
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe lecture.mp4 transcript.txt --model base - transcript.txt 파일을 사용자와 공유하세요.
예제 3: 자막이 있는 웹 최적화 비디오 만들기
사용자 요청:
이 비디오를 웹사이트에 자막과 함께 올려야 해요. 도와주실 수 있나요?
수행할 작업:
- 웹 최적화를 위해 WebM으로 변환하세요:
uv run .claude/skills/video-processor/scripts/video_processor.py to-webm presentation.mp4 presentation.webm - SRT 자막 파일을 생성하세요:
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe presentation.mp4 subtitles.srt --format srt --model small - 사용자에게 다음 항목이 있음을 알려주세요:
- presentation.webm (웹 최적화 비디오)
- subtitles.srt (임베딩용 자막 파일)
예제 4: 언어 지정을 통한 고품질 텍스트 변환
사용자 요청:
게시를 위해 정확한 텍스트 변환이 필요한 스페인어 인터뷰 비디오가 있습니다.
수행할 작업:
- 최상의 정확도를 위해 더 큰 모델과 언어를 지정하여 사용하세요:
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.txt --model medium --language es - 검토를 위해 선택적으로 SRT를 만드세요:
uv run .claude/skills/video-processor/scripts/video_processor.py transcribe interview.mp4 transcript.srt --format srt --model medium --language es - 사용자와 함께 텍스트 변환을 검토하고 필요한 수정을 하세요.
예제 5: 여러 비디오 배치 처리
사용자 요청:
WebM으로 변환하고 텍스트 변환이 필요한 교육 비디오 폴더가 있습니다.
수행할 작업:
- 디렉토리의 모든 비디오 파일을 나열하세요:
ls training_videos/*.mp4 - 각 비디오 파일에 대해 변환 및 텍스트 변환을 실행하세요:
# 각 비디오에 대해: video1.mp4, video2.mp4 등. uv run .claude/skills/video-processor/scripts/video_processor.py to-webm training_videos/video1.mp4 output/video1.webm uv run .claude/skills/video-processor/scripts/video_processor.py transcribe training_videos/video1.mp4 output/video1.txt --model base # 각 파일에 대해 반복 - 모든 변환 및 텍스트 변환이 완료되었는지 확인하세요.
- 출력 파일 요약을 제공하세요.
요약
비디오 프로세서 스킬은 일반적인 비디오 처리 작업을 위한 통합 인터페이스를 제공합니다:
- 오디오 추출: 다양한 포맷으로 오디오 트랙 추출
- 포맷 변환: MP4(범용) 또는 WebM(웹 최적화)으로 변환
- 텍스트 변환: 여러 출력 포맷으로 음성을 텍스트로 변환
- 유연함: 모델 선택, 언어 및 출력 포맷을 위한 CLI 인수
모든 작업은 합리적인 기본값과 포괄적인 오류 처리를 갖춘 단일의 잘 문서화된 스크립트를 통해 처리됩니다.