compose-video

name	compose-video
description	FFmpeg로 이미지, 오디오, 자막, BGM을 합성하여 최종 영상을 만듭니다. 모든 소스가 준비되었을 때 영상 합성이 필요할 때 사용하세요.
allowed-tools	["Bash","Read","Write"]

Compose Video

FFmpeg를 사용하여 이미지, TTS 나레이션, 자막, 배경음악을 하나의 영상으로 합성합니다.

Instructions

1. 이미지, 오디오, 자막 파일 준비
2. VideoComposer 클래스 인스턴스 생성
3. compose() 메서드로 영상 합성
4. MP4 파일로 출력

Usage

from src.quote_video.video_composer import VideoComposer

composer = VideoComposer()
composer.compose(
    image_path="output/scene_001.png",
    audio_path="output/narration_001.wav",
    subtitle_path="output/subtitle_001.srt",
    bgm_path="assets/bgm/gymnopedie_no1.mp3",
    output_path="output/video_001.mp4",
    bgm_volume=0.15
)

Config

항목	값
해상도	1920x1080
프레임레이트	30 fps
코덱	H.264
전환 효과	Fade-in-out (0.5초)
자막 폰트	KOTRA_SONGEULSSI
자막 위치	Bottom-aligned
BGM 볼륨	15-20%

Features

1. Fade 효과: 자연스러운 fade-in/fade-out 전환
2. 자막 오버레이: 손글씨체 자막을 하단에 배치
3. BGM 믹싱: 나레이션과 배경음악 볼륨 자동 조절
4. 고품질 인코딩: H.264 코덱으로 최적의 품질/용량 비율
5. 배치 처리: 여러 씬을 자동으로 연결하여 하나의 영상 생성