Communitygithub.com

ZJU-REAL/Easel

음악 비트 감지를 통해 이미지나 클립을 비트에 맞춰 전환하고, 줌/화이트 플래시 효과를 추가하여 감성적인 '비트 맞춤' 짧은 동영상을 제작합니다.

Easel란 무엇인가요?

이 스킬은 사용자가 업로드한 배경 음악에서 librosa 라이브러리를 사용하여 비트(BPM과 타임포인트)를 자동으로 감지하고, 감지된 비트 지점마다 이미지나 비디오 클립을 하드 컷(경직된 전환)으로 전환하여 리드미컬하고 강렬한 '비트 맞춤' 동영상을 생성합니다. 사용자는 이미지 목록, 음악 파일, 화면 비율(가로/세로)을 제공해야 하며, 선택적으로 전환 빈도(예: 2박마다), 효과(줌 인/화이트 플래시/없음), 최대 길이를 설정할 수 있습니다. 자체 beatsync.py 스크립트를 통해 비트 감지, 구간 분할, 미디어 루핑 및 오디오-비디오 정렬을 일괄 처리하므로 사용자가 수동으로 비트를 세거나 필터를 적용할 필요가 없습니다. 생성된 영상은 `outputs/주제명/` 폴더에 저장되며, 작업 보고서(비트 수, BPM, 사용된 효과 등)도 함께 출력됩니다. 프로필(예: 플랫폼 성향)이 있는 경우 해당 정보를 바탕으로 비트 스타일(빠른 플래시 vs 완만한 줌)과 효과를 계정 성격에 맞게 조정할 수 있지만, 화면 비율은 항상 사용자에게 명확히 확인을 받아야 합니다. 이 스킬은 slideshow-video(고정 시간, 부드러운 전환)와 달리 음악 비트에 동기화된 하드 컷과 특수 효과를 사용하여 '비트 맞춤' 특화 영상을 만듭니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/openclaw/beat-sync-video

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

음악 비트 맞춤 동영상 (비트 믹스)

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 효과.

규칙

  1. 음악 리듬이 명확할수록 비트 맞춤이 정확함; 뚜렷한 비트가 없으면 스크립트가 자동으로 등간격 전환으로 대체하고 보고서에 명시.
  2. 비트 맞춤은 하드 컷 사용 (트랜지션 없음), 그렇지 않으면 비트감이 흐려짐 — 의도된 설계.
  3. 소재 부족 시 자동 루핑; 소재가 충분하면 --every 1~2를 권장하여 각 구간마다 새로운 화면 사용.
  4. 완성 영상은 기본적으로 음악과 같은 길이; --max-duration으로 플랫폼 길이 제한.
  5. 결과물은 항상 outputs/주제명/에 저장.

참고 출처

비트 감지는 librosa beat_track (onset 강도 + 동적 프로그래밍으로 비트 포인트 탐색)을 사용하며, 비트 지점에서 화면을 하드 컷하는 것은 비트 믹스의 표준 방식입니다. 비트→구간→구간별 렌더링→오디오-비디오 정렬을 결정적 스크립트로 캡슐화하여 수동 비트 세기로 인한 불일치를 방지합니다.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ZJU-REAL/Easel

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

ZJU-REAL/Easel

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

ZJU-REAL/Easel

一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns 缓动,需要动态时才逐段图生视频**。当用户说 一键生成视频、自动做短视频、主题生成视频、帮我做条视频、口播视频一条龙、自动出片、短视频一键生成 时使用。**有剧情/角色/对白/反转/多集的短剧改用 short-drama(每镜强制图生视频、不用静态图冒充);只写脚本用 video-script;只生成单个片段用 ai-video-gen。**

ZJU-REAL/Easel

自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。

ZJU-REAL/Easel

Easel clipify: long English talk → punchline cuts → optional 16:9→9:16 face-pan/split → opus word-by-word ASS burn. Ships scripts + assets/preview.png. Part of 1.6k★ Easel suite.

ZJU-REAL/Easel

>- 通用图像处理加工:改尺寸/缩放、裁剪、补边适配平台尺寸、格式转换(png/jpg/webp)、 压缩到目标大小、加文字或图片水印、圆角、多图拼接、生成缩略图、读图片信息。 基于 image_ops.py 确定性处理。 使用时机:用户说"改尺寸"、"缩放图片"、"裁剪"、"压缩图片"、"加水印"、"转格式"、 "圆角"、"拼图/多图联排"、"缩略图"、"适配小红书/朋友圈尺寸"、"把图 pad 成 1:1"。 和 card-*(卡片类)的区别:card-* 是"HTML 设计→渲染出图", image-editing 只加工已有图片,不负责视觉设计。

ZJU-REAL/Easel

多角色对话配音:按 cast 和逐行对白为不同角色分配音色与情绪,合成多声线音轨和带角色名字幕。 当用户说“多角色/双人/剧本/对话配音、多人对白、不同角色不同声音、有声剧配音”时使用。 单一公共音色用 tts-voiceover;克隆本人音色用 voice-clone;整部短剧制作由 short-drama 编排。

ZJU-REAL/Easel

Easel video-highlights: CN/livestream highlight extract + stable static vertical reframe (sibling to clipify).

ZJU-REAL/Easel

>- 视频制作策略与工具选型:AI 视频生成模型对比、视频脚本结构设计、制作流程规划,覆盖产品演示/解说/社媒短视频场景。 当用户说"视频怎么做""视频选型""用什么工具做视频""视频制作流程""视频策略""视频系列规划"时使用。 和 video-script 的区别:video-strategy 做内容规划与工具选型,video-script 写具体某条视频的脚本。

관련 스킬