음악 비트 맞춤 동영상 (비트 믹스)
librosa로 배경 음악의 비트를 감지하여 화면을 비트에 맞춰 하드 컷하고, 비트 효과를 추가하여 '비트 맞춤' 감성 짧은 동영상을 만듭니다. 모든 작업은
skills/shared/scripts/beatsync.py를 통해 진행되며, 수동으로 비트를 세거나 필터를 조합하지 마세요 — 스크립트가 비트 감지, 구간 분할, 미디어 루핑, 오디오-비디오 정렬을 모두 처리합니다.
이미지당 고정 시간의 부드러운 앨범 스타일은 slideshow-video를 참조하세요. 주제 → AI 이미지+오디오+완성 영상은 auto-short-video를 참조하세요.
입력
| 필드 | 필수 | 설명 |
|---|---|---|
| 배경 음악 | 예 | 비트를 결정하는 음악 파일 (리듬이 강할수록 효과가 좋음; 없으면 물어볼 것) |
| 소재 | 예 | 이미지 및/또는 짧은 클립 목록 (순서대로, 루핑 사용) 또는 디렉토리 |
| 화면 비율 | 예 | 가로/세로가 명확하지 않으면 제작 전에 반드시 확인을 받고, 플랫폼이나 프로필 기본값으로 묵시적으로 추정하지 말 것. 이미 명확하면 다시 묻지 않음 |
| 전환 빈도 | 아니요 | 몇 박마다 전환할지 (기본값: 2박) |
| 효과 | 아니요 | zoom 줌 인 (기본값) / flash 화이트 플래시 / none 없음 |
출력 (outputs/주제명/)
- 비트 맞춤 완성 영상 (
*.mp4) - 보고서: 비트 수, 총 길이, 감지된 BPM, 사용된 효과
실행 단계
스크립트 경로 (프로젝트 루트 기준): skills/shared/scripts/beatsync.py (build -h / beats -h).
1. (선택 사항) 비트 미리보기
python skills/shared/scripts/beatsync.py beats --music <음악>
# 템포(BPM)와 비트 타임포인트를 출력하여 --every 값을 결정하는 데 사용
2. 비트 맞춤 영상 생성
python skills/shared/scripts/beatsync.py build \
-i 1.jpg 2.jpg 3.jpg 4.jpg --music <음악> \
-o outputs/주제명/show.mp4 \
--size 1080x1920 --every 2 --effect zoom
- 소재 = 이미지 또는 짧은 클립, 개수가 비트 구간 수보다 적을 수 있음 (자동 루핑).
--every 1매 박자 전환 (빠른 플래시, 소재가 많아야 함);--every 4매 마디 전환 (느긋하게).--effect flash구간 시작에 화이트 플래시로 더 '핫'하게;--effect none깔끔한 하드 컷.--max-duration 15영상 길이 제한 (예: 15초 틱톡).--images-dir <디렉토리>로 파일 이름 순으로 일괄 소재 투입 가능.
프로필 인식
- 프로필 있음:
platforms.md는 화면 비율 제안에만 사용되며, 사용자 확인 필요; 비트 스타일(빠른 플래시/느긋함)과 효과를 계정 성격에 맞춤 (트렌디/스포츠 계정은 빠른 flash, 라이프/힐링 계정은 완만한 zoom). - 프로필 없음: 먼저 가로/세로 확인; 기본값: 2박마다 전환, zoom 효과.
규칙
- 음악 리듬이 명확할수록 비트 맞춤이 정확함; 뚜렷한 비트가 없으면 스크립트가 자동으로 등간격 전환으로 대체하고 보고서에 명시.
- 비트 맞춤은 하드 컷 사용 (트랜지션 없음), 그렇지 않으면 비트감이 흐려짐 — 의도된 설계.
- 소재 부족 시 자동 루핑; 소재가 충분하면
--every 1~2를 권장하여 각 구간마다 새로운 화면 사용. - 완성 영상은 기본적으로 음악과 같은 길이;
--max-duration으로 플랫폼 길이 제한. - 결과물은 항상
outputs/주제명/에 저장.
참고 출처
비트 감지는 librosa beat_track (onset 강도 + 동적 프로그래밍으로 비트 포인트 탐색)을 사용하며, 비트 지점에서 화면을 하드 컷하는 것은 비트 믹스의 표준 방식입니다. 비트→구간→구간별 렌더링→오디오-비디오 정렬을 결정적 스크립트로 캡슐화하여 수동 비트 세기로 인한 불일치를 방지합니다.