Lecture Video Maker

강의자료를 넣으면 **한국어 자막이 번인된 강의 영상(MP4)**을 자동으로 생성하는 Claude Code 스킬 파이프라인입니다.

지원 입력 형식

입력 파일	처리 방식
PPT (.pptx)	텍스트 추출 → JSON 생성 → 파이프라인 실행
Word (.docx)	python-docx로 읽기 → JSON 생성 → 파이프라인 실행
HWP (.hwp)	pyhwpx로 읽기 → JSON 생성 → 파이프라인 실행
Markdown (.md)	직접 읽기 → JSON 생성 → 파이프라인 실행

어떤 형식이든 Claude Code에 "이 파일로 동영상 만들어줘" 하면 자동으로 처리됩니다.

Features

• 다양한 입력 지원: PPT, Word, HWP, Markdown 등 강의자료 형식 무관
• PPT 슬라이드에서 자동 나레이션 대본 생성 (구어체)
• DALL-E 3 배경 일러스트 자동 생성
• ElevenLabs / OpenAI TTS 음성 생성
• 숫자→한글 자동 변환 (TTS 오독 방지)
• 불렛 순차 등장 + 하이라이트 애니메이션
• ffmpeg 영상 합성 (미세 줌 효과)
• 한국어 SRT 자막 번인
• 영상 길이 제한 없음 — 슬라이드 수와 대본 길이에 따라 자동 결정 (슬라이드당 약 30~60초)

Requirements

• Windows + Microsoft PowerPoint (COM 자동화)
• Python 3.10+
• ffmpeg (PATH에 있거나 imageio-ffmpeg 패키지)

Installation

1. Claude Code 스킬로 사용

이 폴더를 Claude Code skills 디렉토리에 복사합니다:

%USERPROFILE%\.claude\skills\lecture-video-maker\

2. API 키 설정

scripts/.env.example을 scripts/.env로 복사하고 API 키를 입력합니다:

cp scripts/.env.example scripts/.env

OPENAI_API_KEY=sk-proj-your-key-here
ELEVENLABS_API_KEY=sk_your-key-here
ELEVENLABS_VOICE_ID=your-voice-id-here
TTS_ENGINE=elevenlabs

3. Python 패키지 설치

pip install python-pptx openai requests mutagen python-dotenv pywin32 lxml imageio-ffmpeg

Usage

Claude Code에서 사용

"동영상 만들어줘"
"강의 영상 만들어줘"
"PPT 영상으로 만들어줘"

직접 실행

cd scripts
PYTHONIOENCODING=utf-8 python run.py "input.json"

자세한 사용법은 SKILL.md를 참조하세요.

Output

output/{title}/
├── {title}.mp4              ← 영상 (자막 없음)
├── {title}_subtitled.mp4    ← 최종 영상 (자막 번인)
├── {title}.pptx             ← PPT 슬라이드
├── {title}.srt              ← SRT 자막
├── audio/                    ← 슬라이드별 TTS 음성
├── images/                   ← 변환된 슬라이드 이미지
└── backgrounds/              ← DALL-E 배경 이미지

License

MIT