raw-video-processing은(는) 무엇을 하나요?
원본 화면 녹화물에서 무음 구간을 제거하고 속도를 조정하여 후처리합니다. FFmpeg 기반 Python 스크립트를 사용하여 자동으로 비디오 페이싱을 최적화합니다.
개요
이 스킬은 화면 녹화(raw screen recording) 파일을 분석하여 무음 구간을 자동으로 감지하고 제거하거나 속도를 높여 비디오의 흐름을 개선합니다. 주로 긴 튜토리얼, 라이브 코딩, 프레젠테이션 녹화물을 더 간결하게 만들 때 유용합니다.
주요 기능
- 무음 구간 감지 및 제거: 오디오 트랙을 분석하여 설정된 임계값 아래의 무음 구간을 찾아냅니다.
- 속도 조정: 무음 구간의 재생 속도를 높이거나 완전히 제거하여 전체 런타임을 단축합니다.
- FFmpeg 기반 처리: 모든 비디오/오디오 처리는 FFmpeg 명령어를 통해 수행되며, Python 스크립트가 이를 자동화합니다.
- 사용자 정의 가능한 파라미터: 무음 감지 임계값(dB), 최소 구간 길이, 속도 배율 등을 조정할 수 있습니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 코딩 에이전트
사용 방법
raw-video-processing디렉토리로 이동합니다.- 입력 비디오 파일을 준비합니다.
- 다음 명령어를 실행합니다:
python process_video.py --input recording.mp4 --output output.mp4 --silence-threshold -30 --speed 2.0
파라미터 설명
| 파라미터 | 설명 | 기본값 |
|---|---|---|
--input | 입력 비디오 파일 경로 | (필수) |
--output | 출력 비디오 파일 경로 | output.mp4 |
--silence-threshold | 무음 감지 임계값 (dB) | -30 |
--min-silence-duration | 최소 무음 구간 길이 (초) | 1.0 |
--speed | 무음 구간 속도 배율 | 2.0 |
의존성
- FFmpeg (시스템에 설치되어 있어야 함)
- Python 3.6 이상
예시
# 기본 사용법
python process_video.py --input tutorial.mp4 --output tutorial_optimized.mp4
# 사용자 정의 임계값과 속도
python process_video.py --input recording.mp4 --output fast.mp4 --silence-threshold -25 --speed 3.0
참고 사항
- 모든 처리는 로컬에서 이루어지며, 외부 API 호출이 없습니다.
- 출력 파일의 품질은 입력과 동일하게 유지됩니다.
- 긴 녹화물의 경우 처리 시간이 몇 분 소요될 수 있습니다.
라이선스
MIT