데모 비디오 생성기은(는) 무엇을 하나요?
개요
단일 프롬프트로 음성 해설, 전환 효과, CSS 애니메이션이 포함된 1920x1080 해상도의 데모 비디오를 생성합니다. Playwright(HTML-to-프레임 렌더링), FFmpeg(합성 및 전환 효과), Edge TTS(신경망 음성 해설) MCP 서버를 조율합니다.
사전 요구 사항
- Python 3.11+ 및
uv패키지 관리자 - FFmpeg 설치 (
ffmpeg -version) - Playwright Chromium 브라우저 (
uv run playwright install chromium) - Edge TTS 음성 합성을 위한 인터넷 연결
설치 방법
마켓플레이스에서 framecraft 플러그인을 설치하세요:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
빠른 시작
uv run python framecraft.py init my-demo # 프로젝트 스캐폴딩
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # 품질 검사
MCP 오케스트레이션
Playwright, FFmpeg, Edge TTS MCP 서버를 사용할 수 있는 경우, framecraft가 이들을 직접 조율하여 각 프레임과 오디오 세그먼트를 최대한 제어합니다.
파이프라인 폴백
MCP 서버를 사용할 수 없는 경우, framecraft는 모든 작업을 한 번에 처리하는 원자적 CLI 파이프라인을 실행합니다.
워크플로
- 스토리 설계 -- 내러티브 아크 선택 (문제-해결, 히어로 저니, 전후 비교)
- 장면 작성 -- CSS 애니메이션이 포함된 HTML 장면을 작성하거나 내장 템플릿 사용
- 렌더링 -- Playwright가 프레임을 캡처하고, Edge TTS가 음성 해설을 생성하며, FFmpeg가 합성
출력
- 음성 해설 및 전환 효과가 포함된 1920x1080 MP4 비디오
- 반복 작업을 위한 개별 장면 미리보기
- 품질 보증을 위한 검증 보고서
오류 처리
| 오류 | 원인 | 해결 방법 |
|---|---|---|
ffmpeg: command not found | FFmpeg 미설치 | brew install ffmpeg 또는 시스템 패키지 관리자로 설치 |
playwright._impl._errors.Error | Chromium 미설치 | uv run playwright install chromium 실행 |
edge_tts.exceptions.NoAudioReceived | TTS 서비스 사용 불가 | 인터넷 연결 확인; 몇 초 후 재시도 |
FileNotFoundError: scenes.json | 장면 설정 파일 누락 | 먼저 uv run python framecraft.py init my-demo 실행 |
| 빈 프레임 또는 검은 프레임 | HTML 장면 렌더링 실패 | HTML 구문 확인 및 자산 접근 가능 여부 확인 |
예제
{
"scenes": [
{
"title": "Meet YourApp",
"subtitle": "작업을 더 스마트하게 관리하는 방법",
"narration": "24개의 작업. 하나의 대시보드. 스트레스 제로.",
"voice": "en-US-AndrewNeural",
"bullets": ["스마트 우선순위", "팀 동기화", "원클릭 보고서"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = TTS 길이에서 자동 감지 + 1.5초 버퍼.
리소스
- 템플릿 및 파이프라인이 포함된 소스 저장소: github.com/vaddisrinivas/framecraft
- Edge TTS 음성 목록
- Playwright 문서
- FFmpeg 문서