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%