Communitygithub.com

ZJU-REAL/Easel

범용 오디오 처리: 오디오 클립/자르기, 포맷 변환(mp3/wav/m4a/aac), 볼륨 정규화, 비디오에서 오디오 추출, 다중 구간 연결, 페이드 인/아웃, 속도 변경(음높이 유지).

Easel란 무엇인가요?

이 기술은 노이즈 제거를 제외한 일반적인 오디오 작업을 위한 포괄적인 스킬입니다. 사용자는 오디오 클립 자르기, 포맷 변환, 볼륨 정규화, 비디오에서 오디오 추출, 여러 오디오 파일 연결, 페이드 인/아웃 적용, 음높이를 유지하면서 재생 속도 변경 등을 수행할 수 있습니다. 이 스킬은 모든 ffmpeg 호출을 중앙 집중식 스크립트로 캡슐화하여 일관되고 재현 가능한 오디오 처리를 보장합니다. 주로 Claude Code, Cursor와 같은 AI 에이전트 플랫폼과 통합되며, 사용자의 프로필 설정에 따라 매개변수를 자동 조정하여 대상 플랫폼(예: 소셜 미디어, 팟캐스트)에 최적화된 출력을 제공합니다. 이 스킬은 노이즈 제거 전용 스킬을 보완하여 범용 오디오 편집 워크플로우에 이상적입니다.

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

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

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

문서

범용 오디오 처리

노이즈 제거를 제외한 범용 오디오 작업: 자르기, 변환, 볼륨 정규화, 오디오 추출, 연결, 페이드 인/아웃, 속도 변경. 모든 작업은 공유 스크립트 skills/shared/scripts/audio_ops.py를 통해 ffmpeg를 캡슐화하며, 매개변수가 결정적이고 재현 가능하며 현장에서 명령을 수동으로 조합하지 않습니다.

입력

필드필수설명
input_file예오디오 또는 비디오 파일 경로
operation예trim / convert / normalize / extract / concat / fade / speed / denoise / info
output_file아니오기본값 outputs/주제명/{name}-{op}.{ext}

지원 포맷: wav / mp3 / m4a / aac / flac, 비디오 컨테이너 mp4 / mkv / mov (오디오 추출용).

출력

  • 처리된 오디오 파일 (outputs/주제명/에 저장)
  • 각 작업마다 실제 실행된 ffmpeg 명령어와 출력 파일의 길이/비트레이트/채널/샘플레이트 출력

실행 단계

스크립트 경로 (프로젝트 루트 기준): skills/shared/scripts/audio_ops.py. 각 하위 명령어는 -h를 지원합니다.

0. 환경 확인 + 탐지

python skills/shared/scripts/audio_ops.py info input.mp3

스크립트 자체적으로 ffmpeg/ffprobe를 확인하며, 없으면 설치 안내 메시지를 표시합니다. 먼저 info로 파일 길이/비트레이트/채널을 확인한 후 작업을 시작합니다.

1. 자르기 trim

# 시작 및 종료 시간
python skills/shared/scripts/audio_ops.py trim in.mp3 -o outputs/주제명/clip.mp3 --start 00:00:05 --end 00:00:20
# 시작점 + 길이
python skills/shared/scripts/audio_ops.py trim in.mp3 -o clip.mp3 --start 5 --duration 15

2. 변환 convert

python skills/shared/scripts/audio_ops.py convert in.wav -o out.mp3 --bitrate 192k
python skills/shared/scripts/audio_ops.py convert in.m4a -o out.wav --sample-rate 44100 --channels 2

출력 포맷은 확장자에 의해 결정됩니다 (mp3/wav/m4a/aac).

3. 볼륨 정규화 normalize

python skills/shared/scripts/audio_ops.py normalize in.mp3 -o out.mp3

기본 loudnorm으로 -14 LUFS / -1.5 dBTP (소셜 미디어/팟캐스트 공용 음량). --i --tp --lra로 재정의할 수 있습니다.

4. 오디오 추출 extract

python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.m4a
python skills/shared/scripts/audio_ops.py extract video.mp4 -o audio.aac --copy   # 재인코딩 없음, 가장 빠름

5. 연결 concat

python skills/shared/scripts/audio_ops.py concat a.mp3 b.mp3 c.mp3 -o all.mp3

매개변수 순서대로 연결하며, 재인코딩 방식으로 다른 샘플레이트/컨테이너와 호환됩니다.

6. 페이드 인/아웃 fade

python skills/shared/scripts/audio_ops.py fade in.mp3 -o out.mp3 --fade-in 2 --fade-out 3

--fade-out은 자동으로 끝에서 N초 전으로 위치를 지정합니다.

7. 속도 변경 speed (음높이 유지)

python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 1.5   # 1.5배속
python skills/shared/scripts/audio_ops.py speed in.mp3 -o out.mp3 --factor 0.8   # 느리게

atempo 기반 음높이 유지, 0.5-2.0 범위를 초과하면 자동으로 계단식 적용.

8. 노이즈 제거 denoise (보조용, 전용 작업은 audio-denoise 사용)

python skills/shared/scripts/audio_ops.py denoise in.wav -o out.wav --tier 2

audio-denoise와의 경계

  • audio-denoise: 노이즈 제거 전용 SKILL, 레벨 선택, 모델 다운로드, 노이즈 제거 보고서 등 전체 프로세스를 담당합니다. 진지한 노이즈 제거가 필요할 때 사용하세요.
  • audio-editing: 범용 오디오 처리. denoise 하위 명령어는 편의를 위한 보조 기능일 뿐입니다. 둘 다 동일한 audio_ops.py denoise를 호출하며, 기능은 동일하고 위치만 다릅니다.

규칙

  1. 원본 파일을 절대 삭제하지 않음 — 새 파일만 outputs/주제명/에 씁니다.
  2. 먼저 info를 확인한 후 처리 — 파일 정보를 표시하여 오작동을 방지합니다.
  3. 비디오 입력은 오디오만 처리 — denoise는 비디오에 대해 자동으로 -c:v copy 사용; 순수 오디오 추출은 extract 사용.
  4. 투명한 실행 — 스크립트는 실제 ffmpeg 명령어를 출력합니다.
  5. Profile 없이도 사용 가능 — 오디오 처리는 사용자 계정 프로필에 의존하지 않습니다.

Profile 인식

Profile이 있는 경우 플랫폼 선호도에 따라 기본 매개변수(예: 숏폼 음량, 목표 비트레이트)를 선택할 수 있으며, Profile이 없는 경우 범용 기본값(-14 LUFS, 192k)으로 대체됩니다.

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

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

ZJU-REAL/Easel

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

ZJU-REAL/Easel

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。

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 写具体某条视频的脚本。

관련 스킬