AgentSkillsCN

compose-video

使用FFmpeg将图像、音频、字幕和背景音乐进行合成，制作出最终视频。当所有素材都已准备就绪，且需要进行视频合成时，请使用此功能。

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

Compose Video

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

Instructions

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

Usage

python
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. •배치 처리: 여러 씬을 자동으로 연결하여 하나의 영상 생성