Video Subtitle Skill
비디오에 자동으로 중국어 자막을 추가합니다. JianYing의 자동 자막 기능과 유사합니다.
기능
- Whisper AI를 사용하여 비디오 음성 인식 및 영어 자막 생성
- 자동으로 중국어 자막으로 번역
- FFmpeg를 사용하여 자막을 비디오에 하드코딩
사용 방법
# 기본 사용법
clawhub install video-subtitle
# 또는 agent 에게 직접 지시
"이 비디오에 중국어 자막을 추가해줘"
사전 요구 사항
-
ffmpeg - 반드시 설치
apt-get install -y ffmpeg -
Python 환경 - 다음 패키지 필요:
pip install faster-whisper translators
명령줄 사용법
# 비디오에 자막 추가
node /root/.openclaw/workspace/skills/video-subtitle/add-subtitle.js <비디오 경로> [대상 언어]
# 예시
node add-subtitle.js /path/to/video.mp4 zh
전체 프로세스
- 음성 인식 - faster-whisper를 사용하여 영어 자막 추출
- 번역 - Google 번역 API를 사용하여 중국어로 변환
- 하드코딩 - FFmpeg로 자막을 비디오에 인코딩
출력
- 원본 비디오 + 중국어 자막이 포함된 새 비디오 파일
- 동일한 이름의 .srt 자막 파일 (선택 사항)
주의 사항
- 비디오 길이는 처리 시간에 영향을 미칩니다 (음성 인식이 병목)
- MP4, MOV, AVI 등 일반적인 비디오 형식 지원
- 기본 Whisper 모델은 "base" (CPU 친화적)
- 더 높은 정확도가 필요하면 "large" 모델 사용 가능 (메모리 더 필요)
자막 수정
생성된 자막에 오류(예: 고유 명사 인식 오류)가 있는 경우:
- 생성된 .srt 파일을 수동으로 편집
- 하드코딩 단계만 다시 실행
# 자막만 다시 하드코딩 (음성 인식 재실행 없음)
ffmpeg -i input.mp4 -vf "subtitles=corrected.srt" -c:a copy output.mp4
저자: Bubble 🫧
버전: 1.0.0
업데이트: 2026-03-05