SKILL.md
PPT to Video Workflow
PPT/슬라이드를 나레이션과 자막이 포함된 영상으로 변환하는 종합 스킬입니다.
트리거
다음과 같은 요청 시 이 스킬을 사용합니다:
- "PPT를 영상으로 만들어줘"
- "슬라이드 영상 생성해줘"
- "발표 영상 만들어줘"
- "나레이션이 포함된 영상 생성"
- "자막 포함 영상 만들어줘"
- "PPTX 파일을 영상으로 변환"
전체 워크플로우
┌─────────────────────────────────────────────────────────────────────┐
│ 입력 소스 (택1) │
├─────────────────────────────────────────────────────────────────────┤
│ [PPTX 파일] 또는 [slides.json] │
│ │ │ │
│ ▼ ▼ │
│ 이미지 추출 (python-pptx) 슬라이드 렌더링 (Pillow) │
│ │ │ │
│ └───────────────┬───────────────────────┘ │
│ ▼ │
│ slide_01.png, slide_02.png, ... │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ 나레이션 생성 │
├─────────────────────────────────────────────────────────────────────┤
│ [slides.json + reference_audio.wav] │
│ │ │
│ ▼ │
│ Chatterbox TTS API (슬라이드별 음성 생성) │
│ │ │
│ ▼ │
│ narration_01.mp3, narration_02.mp3, ... + timing.json │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ 자막 생성 (선택) │
├─────────────────────────────────────────────────────────────────────┤
│ [timing.json] │
│ │ │
│ ▼ │
│ 문장 분할 + ASS 자막 생성 │
│ │ │
│ ▼ │
│ subtitle.ass │
└─────────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────────┐
│ 영상 합성 │
├─────────────────────────────────────────────────────────────────────┤
│ [slide_*.png + narration_*.mp3 + subtitle.ass] │
│ │ │
│ ▼ │
│ FFmpeg (페이드 전환 + 자막 하드코딩) │
│ │ │
│ ▼ │
│ final_video.mp4 │
└─────────────────────────────────────────────────────────────────────┘입력 형식
옵션 1: PPTX 파일
기존 PPTX 파일에서 슬라이드 이미지를 추출합니다.
from pptx import Presentation
from pptx.enum.shapes import MSO_SHAPE_TYPE
from PIL import Image
import io
prs = Presentation("presentation.pptx")
for i, slide in enumerate(prs.slides):
for shape in slide.shapes:
if shape.shape_type == MSO_SHAPE_TYPE.PICTURE:
image = Image.open(io.BytesIO(shape.image.blob))
image.save(f"slide_{i+1:02d}.png")옵션 2: slides.json
구조화된 JSON에서 슬라이드를 렌더링합니다.
{
"slides": [
{
"slide": 1,
"title": "슬라이드 제목",
"content": ["항목1", "항목2", "항목3"],
"narration": "이 슬라이드에서 읽을 전체 대본 텍스트입니다."
}
]
}필수 파일
- reference_audio.wav: 음성 클로닝을 위한 참조 음성 (3-10초)
스크립트
1. render_slides.py
slides.json을 1920x1080 이미지로 렌더링합니다.
# Academic 테마 (기본, 흰색 배경)
python scripts/render_slides.py slides.json -i generated_images/ -o rendered_slides/
# RDF 다크 테마 (골드/청록 강조)
python scripts/render_slides.py slides.json -i generated_images/ -o rendered_slides/ -t rdf옵션:
-i, --images: AI 생성 이미지 디렉토리-o, --output: 출력 디렉토리-t, --theme: 테마 선택 (academic또는rdf)
출력: renderedslides/slide01.png, slide_02.png, ...
2. generate_narration.py
슬라이드별 TTS 음성을 생성합니다.
python scripts/generate_narration.py slides.json reference_audio.wav -o narrations/옵션:
-o, --output: 출력 디렉토리-l, --language: 언어 코드 (기본:ko)
출력:
narrations/narration01.mp3,narration02.mp3, ...narrations/timing.json(시간 정보 + 전체 텍스트)
timing.json 구조:
{
"total_slides": 17,
"total_duration": 374.96,
"slides": [
{
"slide": 1,
"audio_file": "narrations/narration_01.mp3",
"duration": 11.76,
"text": "전체 나레이션 텍스트..."
}
]
}3. generate_subtitles.py
timing.json에서 ASS 자막 파일을 생성합니다.
python scripts/generate_subtitles.py narrations/timing.json -o subtitle.ass자막 분할 규칙:
- 한 자막당 최대 2줄
- 줄당 최대 40자 (한글 기준)
- 구두점(., !, ?) 기준 분할
- 최소 2초 표시 시간 보장
출력: subtitle.ass
4. create_video.py
이미지와 나레이션을 합성하여 영상을 생성합니다.
# 기본 (자막 없음)
python scripts/create_video.py rendered_slides/ narrations/ -o final_video.mp4
# 자막 포함
python scripts/create_video.py rendered_slides/ narrations/ -o final_video.mp4 --subtitle
# 페이드 효과 없이
python scripts/create_video.py rendered_slides/ narrations/ -o final_video.mp4 --no-fade옵션:
-o, --output: 출력 파일명--subtitle: 자막 포함 (ASS 파일 자동 생성)--no-fade: 페이드 전환 효과 비활성화
출력:
final_video.mp4final_video.ass(--subtitle 사용 시)
전체 워크플로우 예시
케이스 1: slides.json에서 영상 생성
# 1. 슬라이드 렌더링
python ~/.claude/skills/ppt-to-video-workflow/scripts/render_slides.py \
slides.json -i generated_images/ -o rendered_slides/ -t rdf
# 2. 나레이션 생성
python ~/.claude/skills/ppt-to-video-workflow/scripts/generate_narration.py \
slides.json reference_audio.wav -o narrations/
# 3. 영상 합성 (자막 포함)
python ~/.claude/skills/ppt-to-video-workflow/scripts/create_video.py \
rendered_slides/ narrations/ -o presentation.mp4 --subtitle케이스 2: PPTX 파일에서 영상 생성
# 1. PPTX에서 이미지 추출
from pptx import Presentation
from pptx.enum.shapes import MSO_SHAPE_TYPE
from PIL import Image
import io, os
os.makedirs("pptx_slides", exist_ok=True)
prs = Presentation("presentation.pptx")
for i, slide in enumerate(prs.slides):
for shape in slide.shapes:
if shape.shape_type == MSO_SHAPE_TYPE.PICTURE:
img = Image.open(io.BytesIO(shape.image.blob))
img = img.resize((1920, 1080), Image.LANCZOS)
img.save(f"pptx_slides/slide_{i+1:02d}.png")
break# 2. 나레이션 생성 (slides.json 필요)
python ~/.claude/skills/ppt-to-video-workflow/scripts/generate_narration.py \
slides.json audio.wav -o narrations/
# 3. 영상 합성
python ~/.claude/skills/ppt-to-video-workflow/scripts/create_video.py \
pptx_slides/ narrations/ -o output.mp4 --subtitle케이스 3: 기존 영상에 자막만 추가
# 1. 자막 파일 생성
python ~/.claude/skills/ppt-to-video-workflow/scripts/generate_subtitles.py \
narrations/timing.json -o subtitle.ass
# 2. FFmpeg로 자막 하드코딩
ffmpeg -i input.mp4 -vf "ass=subtitle.ass" -c:a copy output_with_subtitle.mp4테마
Academic (기본)
- 흰색 배경
- 빨간색 강조 (#DC3545)
- 얇은 상단 바
- 심플한 불릿 포인트
RDF Dark Theme
- 다크 헤더 (#1A1A1A) + 격자 도트 패턴
- 골드 강조 (#F5A623)
- 청록 보조 (#4ECDC4)
- 골드 세로바 섹션 제목
- 이미지에 그림자 효과
- 청록색 하단 바
설정
| 항목 | 값 |
|---|---|
| 해상도 | 1920x1080 (Full HD) |
| FPS | 30 |
| 영상 형식 | MP4 (H.264 + AAC) |
| 전환 효과 | 페이드 (0.5초) |
| 한글 폰트 | AppleSDGothicNeo, NanumGothic |
| 테마 | academic, rdf |
| 자막 형식 | ASS (Advanced SubStation Alpha) |
| 자막 폰트 | AppleSDGothicNeo-Medium (42pt) |
| 자막 위치 | 하단 중앙 |
| 자막 배경 | 반투명 검정 (50% opacity) |
의존성
pip install pillow pydub gradio-client python-pptx- Python 3.x
- Pillow: 이미지 렌더링
- FFmpeg: 영상 합성 (시스템 설치 필요)
- pydub: 오디오 처리
- gradio-client: Chatterbox TTS API
- python-pptx: PPTX 파일 처리
디렉토리 구조
ppt-to-video-workflow/
├── SKILL.md # 이 문서
└── scripts/
├── render_slides.py # 슬라이드 → 이미지 렌더링
├── generate_narration.py # TTS 나레이션 생성
├── generate_subtitles.py # ASS 자막 생성
└── create_video.py # 영상 합성관련 스킬
academic-ppt-generator: slides.json 생성 및 PPTX 변환chatterbox-tts-workflow: TTS 생성 (단일 파일)
예상 결과물
입력:
slides.json(제목, 내용, 나레이션)reference_audio.wav(참조 음성)
출력:
slide_*.png(슬라이드 이미지들)narration_*.mp3(슬라이드별 음성)timing.json(타이밍 정보)subtitle.ass(자막 파일)final_video.mp4(최종 영상)