Communitygithub.com

clean-audio (オーディオクリーンアップ)

動画の音声からランブル、ハム音、背景ノイズ、ヒスノイズ、濁った音、鋭いS音、音量の不均一さを除去し、リップシンクを維持します。

clean-audio (オーディオクリーンアップ) とは?

このスキルは、動画内のボイスオーディオを自動的にクリーンアップします。ランブル、電気的ハム、背景ノイズ、ヒスノイズ、濁った音や鋭いS音、音量の不均一さを検出し、最適な強度で除去します。まず10秒のサンプルで前後比較を生成し、ユーザーに品質を確認させます。その後、本処理では音声の明瞭性を損なわない範囲で最も効果的なクリーンアップを自動選択します。Whisperを使用して単語の明瞭性を監視し、元の音声との信頼度の差が0.015以内になるように保ちます。YouTube、Instagram、TikTok向けのラウドネス(-14 LUFS)に自動調整し、リップシンクを完全に維持します。rough-cutスキルと統合されており、編集前の生クリップに対してクリーンアップを行います。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dotslashsimran/simcraft/tree/HEAD/skills/clean-audio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

オーディオクリーンアップ

rough-cutスキルのPythonで実行します:PY=~/simcraft/skills/rough-cut/.venv/bin/python(存在しない場合はsh ~/simcraft/skills/rough-cut/setup.shを一度実行してください)。rough-cutのヘルパーを共有し、Whisperを使用して明瞭性をチェックします。

手順

  1. まずリスニングテストを行います。 最も忙しい会話の瞬間の10秒間の前後比較を作成します。両方とも同じラウドネスに設定されているため、比較は音量ではなく品質について行われます:

    $PY scripts/clean_audio.py <video> --sample
    

    両方のwavファイルをユーザーに開き(open <before> <after>)、レポートを提供します。

  2. 適用します。 2つの実行方法があります:

    • rough-cutワークスペース内で、レンダリング前に行う場合。各生クリップをaudio/<clip>.clean.wavにクリーンアップし、rough-cutのrender.pyが自動的にそれらを使用します:
      $PY scripts/clean_audio.py <workspace>
      
      その後、通常通りレンダリングして確認します。レポートはaudio/cleanup.mdに保存されます。
    • 単一の動画に対して行う場合。元のファイルの隣に<name>_clean.<ext>を書き込み、動画はそのままコピーされます:
      $PY scripts/clean_audio.py <video>
      
  3. レポートは平易な言葉で以下の内容を含みます:

    • 前後の音声と背景の差
    • 最終的なラウドネス
    • 検出された内容(ハム、クリッピング)
    • 明瞭性チェックで採用された強度

    レポートに残留ノイズが声や音楽であると記載されている場合、これらのフィルタでは除去できないことをユーザーに伝え、AI音声アイソレータを提案します。

オプション

  • --strength strong|medium|light 試行する最大のデノイズ強度を設定します。デフォルトはmediumで、明瞭性チェックが自動的に強度を下げます。
  • --target -14 ラウドネスをLUFSで設定します。-14はYouTube、Instagram、TikTokに適しており、ポッドキャストには-16を使用します。
  • --no-eq トーンシェーピングをスキップします。ユーザーが自分の声をそのまま好む場合に使用します。

ルール

  • カット前の生クリップをクリーンアップし、カット後ではありません。 ノイズは無音部分から学習され、rough-cutは無音部分を削除します。
  • 元のファイルには決して触れないでください。
  • 明瞭性を静かさと引き換えにしないでください。明瞭性チェックがこれを強制します:単語の欠落がなく、元の音声との信頼度の差が0.015以内であること。
  • 単語間のオーディオをデジタルサイレンスにしないでください。意図的に少しの室内音を残します。

各ステップの動作、このように構築された理由、テスト数値については:reference.mdを参照してください。

Individual skills in this repo

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

関連スキル