범용 오디오 처리
노이즈 제거를 제외한 범용 오디오 작업: 자르기, 변환, 볼륨 정규화, 오디오 추출, 연결, 페이드 인/아웃, 속도 변경. 모든 작업은 공유 스크립트 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를 호출하며, 기능은 동일하고 위치만 다릅니다.
규칙
- 원본 파일을 절대 삭제하지 않음 — 새 파일만
outputs/주제명/에 씁니다. - 먼저 info를 확인한 후 처리 — 파일 정보를 표시하여 오작동을 방지합니다.
- 비디오 입력은 오디오만 처리 — denoise는 비디오에 대해 자동으로
-c:v copy사용; 순수 오디오 추출은 extract 사용. - 투명한 실행 — 스크립트는 실제 ffmpeg 명령어를 출력합니다.
- Profile 없이도 사용 가능 — 오디오 처리는 사용자 계정 프로필에 의존하지 않습니다.
Profile 인식
Profile이 있는 경우 플랫폼 선호도에 따라 기본 매개변수(예: 숏폼 음량, 목표 비트레이트)를 선택할 수 있으며, Profile이 없는 경우 범용 기본값(-14 LUFS, 192k)으로 대체됩니다.