bilingual-subtitle-skill은(는) 무엇을 하나요?
자동 이중 언어 자막(넷플릭스 스타일, Gemini, FFmpeg)을 위한 Claude Code 스킬입니다.
기능
- 자동 번역: Gemini AI를 사용하여 자막 텍스트를 번역합니다.
- 이중 자막 형식: 원본 텍스트는 화면 상단에, 번역 텍스트는 하단에 표시합니다.
- 입력 형식: SRT, VTT 파일 지원.
- 출력 형식: 넷플릭스 스타일의 ASS(Advanced SubStation Alpha) 자막 파일을 생성합니다.
- FFmpeg 통합: 생성된 ASS 자막을 비디오에 하드코딩할 수 있습니다.
요구 사항
- Claude Code CLI
- Gemini API 키 (
GEMINI_API_KEY환경 변수 설정) - FFmpeg (설치되어 있어야 함)
설치
이 스킬을 프로젝트에 복사하거나, Claude Code 설정에 추가하십시오.
사용법
-
자막 파일 준비: 번역할 원본 자막 파일(SRT 또는 VTT)을 준비합니다.
-
환경 변수 설정:
export GEMINI_API_KEY="your-gemini-api-key" -
스킬 실행: Claude Code 내에서 자막 파일 경로를 인자로 전달하여 스킬을 호출합니다.
claude code bilingual-subtitle path/to/subtitle.srt -o output.ass
예시
입력 (SRT):
1
00:00:01,000 --> 00:00:04,000
Hello, world!
출력 (ASS):
[Script Info]
; Script generated by bilingual-subtitle-skill
ScriptType: v4.00+
[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Original,Arial,20,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,2,2,8,10,10,10,1
Style: Translation,Arial,18,&H00FFFF00,&H000000FF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,2,2,2,10,10,10,1
[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:01.00,0:00:04.00,Original,,0,0,8,,Hello, world!
Dialogue: 0,0:00:01.00,0:00:04.00,Translation,,0,0,2,,안녕, 세상아!
옵션
| 옵션 | 설명 |
|---|---|
-o, --output | 출력 ASS 파일 경로 (기본값: input_bilingual.ass) |
--lang | 번역 대상 언어 (기본값: 'ko') |
--model | Gemini 모델 이름 (기본값: 'gemini-pro') |
통합
FFmpeg를 사용하여 이중 자막을 동영상에 하드코딩할 수 있습니다.
ffmpeg -i input.mp4 -vf "ass=output.ass" output.mp4
참고 사항
- Gemini API 사용에는 비용이 발생할 수 있습니다. 사용량과 할당량을 확인하십시오.
- 자막 형식이 올바른지 확인하십시오. 잘못된 형식은 번역 또는 출력 생성 시 오류를 발생시킬 수 있습니다.
- 이 스킬은 Claude Code의 컨텍스트 내에서 파일 시스템에 접근하고 Gemini API를 호출합니다.