Communitygithub.com

오디오 정리

영상 속 음성 오디오를 깨끗하게 정리합니다: 웅웅거림, 전기적 잡음, 배경 소음과 쉿소리, 탁하거나 거친 톤, 날카로운 'ㅅ' 발음, 불균일한 볼륨 및 YouTube/Instagram/TikTok에 맞는 음량을 조정합니다. 먼저 오디오를 측정하여 단어 명료도를 해치지 않는 최선의 정리 강도를 선택하고 립싱크를 정확히 유지합니다.

오디오 정리란 무엇인가요?

이 스킬은 영상 편집 워크플로우에서 오디오 품질을 자동으로 개선하는 전문 도구입니다. 사용자가 "오디오 정리", "소리 수정", "배경 소음 제거" 등을 요청하거나 러프 컷 이후에 활용할 수 있습니다. 주요 기능으로는 럼블, 전기적 험, 배경 잡음, 쉿소리, 탁한 음색, 날카로운 치찰음, 불균일한 볼륨을 감지하고 보정하며, YouTube/Instagram/TikTok 등 플랫폼에 맞는 음량 (-14 LUFS)을 자동으로 맞춥니다. 이 스킬은 먼저 10초 샘플을 통해 오디오를 분석하고, Whisper를 이용한 명료도 검사를 통해 단어가 손실되지 않으면서도 최대한 강력한 정리를 적용합니다. 러프 컷 스킬과 통합되어 있어 각 원본 클립을 개별적으로 정리한 후 최종 렌더링 시 자동으로 사용됩니다. 사용자는 강도(강/중/약), 목표 음량, 이퀄라이저 사용 여부를 선택할 수 있으며, 스킬은 항상 원본 파일을 보존하고 디지털 사일런스를 최소화하여 자연스러운 오디오를 유지합니다. 배경에 음악이나 사람 목소리가 남아 있으면 AI 음성 분리기를 제안합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/clean-audio

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

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

문서

오디오 정리은(는) 무엇을 하나요?

러프 컷 스킬의 Python으로 실행: PY=~/simcraft/skills/rough-cut/.venv/bin/python (sh ~/simcraft/skills/rough-cut/setup.sh를 한 번 실행하여 환경을 만듭니다). 러프 컷의 헬퍼를 공유하며 명료도 검사에 Whisper를 사용합니다.

절차

  1. 먼저 청음 테스트. 가장 말이 많은 순간의 10초 전후 비교 구간을 만듭니다. 둘 다 동일한 음량으로 설정되어 있으므로 비교는 음질에 대한 것이지 볼륨이 아닙니다:

    $PY scripts/clean_audio.py <비디오> --sample
    

    두 wav 파일을 사용자에게 열어주고 (open <전> <후>) 보고서를 제공합니다.

  2. 적용. 실행 방법은 두 가지입니다:

    • 러프 컷 워크스페이스에서, 렌더링 전에. 각 원본 클립을 audio/<클립>.clean.wav로 정리하면 러프 컷의 render.py가 자동으로 이를 사용합니다:
      $PY scripts/clean_audio.py <워크스페이스>
      
      그런 다음 평소처럼 렌더링하고 확인합니다. 보고서는 audio/cleanup.md에 저장됩니다.
    • 단일 비디오에 대해. 원본 파일 옆에 <이름>_clean.<확장자>를 쓰고 비디오는 건드리지 않고 복사합니다:
      $PY scripts/clean_audio.py <비디오>
      
  3. 보고서를 평이한 용어로 제공:

    • 전후 음성 대 배경 소음 차이,
    • 최종 음량,
    • 발견된 사항 (험, 클리핑),
    • 명료도 검사가 결정한 강도.

    보고서에 남은 잡음이 목소리나 음악이라고 표시되면, 해당 필터로는 제거할 수 없다고 사용자에게 알리고 AI 음성 분리기를 제안합니다.

옵션

  • --strength strong|medium|light 시도할 최대 잡음 제거 강도를 설정합니다. 기본값은 medium이며, 명료도 검사가 자동으로 강도를 낮춥니다.
  • --target -14 음량을 LUFS 단위로 설정합니다. -14는 YouTube, Instagram 및 TikTok에 적합하며, 팟캐스트에는 -16을 사용하십시오.
  • --no-eq 사용자가 자신의 목소리를 있는 그대로 선호하는 경우 톤 셰이핑을 건너뜁니다.

규칙

  • 자르기 전에 원본 클립을 정리하십시오. 자른 후가 아닙니다. 잡음은 일시 정지에서 학습되며 러프 컷은 일시 정지를 제거합니다.
  • 원본 파일을 절대 건드리지 마십시오.
  • 조용함을 위해 명료도를 절대 희생하지 마십시오. 명료도 검사가 이를 강제합니다: 단어 손실 없음, 신뢰도가 원본의 0.015 이내.
  • 단어 사이의 오디오를 디지털 무음으로 밀어 넣지 마십시오. 약간의 방 소음은 의도적으로 유지됩니다.

각 단계가 수행하는 작업, 이러한 방식으로 구축된 이유 및 테스트 수치: reference.md.

Individual skills in this repo

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

관련 스킬