video-audio-extractor について
ローカル動画ファイルや動画 URL から音声を抽出するコマンドラインスキルです。yt-dlp を使った YouTube 対応に加え、複数の出力形式やビットレート、サンプルレート、保存先を指定できます。
主な機能
- 01ローカル動画から音声を抽出
- 02動画 URL の処理
- 03yt-dlp による YouTube 抽出
- 04形式と音質の選択
- 05保存先指定と動画の保持
活用シーン
- 01動画ファイルから MP3 を作成
- 02YouTube 音声を M4A で保存
- 03FLAC でロスレス音声を出力
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/video-audio-extractorを入力して読み込まれたか確認します。
同梱ファイルREADME.mdscripts/extract-audio.py
詳細
動画音声抽出ツール
動画ファイルまたは URL から音声を抽出します。MP3、WAV、M4A、FLAC、OGG、OPUS など、さまざまな出力形式に対応しています。
主な機能
- ✅ ローカルの動画ファイルから音声を抽出
- ✅ 動画の直接 URL からダウンロードして抽出
- ✅ YouTube に対応 — 音声を直接抽出（yt-dlp が必要）
- ✅ 品質を調整できる複数の出力形式
- ✅ 一時ファイルを自動的にクリーンアップ
前提条件
# Required
brew install ffmpeg
# Optional - for YouTube support
pip3 install yt-dlp
クイックスタート
ローカルファイルから抽出
{baseDir}/scripts/extract-audio.py video.mp4
# Creates: video.mp3
YouTube から抽出
{baseDir}/scripts/extract-audio.py "https://youtube.com/watch?v=..."
形式を指定
{baseDir}/scripts/extract-audio.py video.mp4 -f wav # WAV format
{baseDir}/scripts/extract-audio.py video.mp4 -f m4a # Apple format
{baseDir}/scripts/extract-audio.py video.mp4 -f flac # Lossless
使い方
extract-audio.py [-h] [-o OUTPUT] [-f {mp3,wav,m4a,aac,flac,ogg,opus}]
[-b BITRATE] [-r SAMPLE_RATE] [--keep-video] [--video-only]
input
オプション
| オプション | 説明 | デフォルト |
|---|---|---|
input | 動画ファイルのパスまたは URL | （必須） |
-o, --output | 出力音声ファイルのパス | 自動生成 |
-f, --format | 出力形式 | mp3 |
-b, --bitrate | 音声ビットレート | 192k |
-r, --sample-rate | サンプルレート（Hz） | 元の値 |
--keep-video | ダウンロードした動画を保持 | ダウンロード後に削除 |
--video-only | 音声を抽出せずに動画をダウンロード | 無効 |
対応形式
| 形式 | コーデック | 備考 |
|---|---|---|
| MP3 | libmp3lame | 最も高い互換性 |
| WAV | pcm_s16le | 非圧縮のため、ファイルサイズが大きくなります |
| M4A | AAC | Apple のエコシステム向け |
| FLAC | FLAC | 可逆圧縮 |
| OGG | Vorbis | オープン形式 |
| OPUS | Opus | ストリーミング向けに最適化 |
使用例
高音質の MP3
{baseDir}/scripts/extract-audio.py video.mp4 -b 320k -r 48000
YouTube から M4A に変換
{baseDir}/scripts/extract-audio.py "https://youtu.be/xxxxx" -f m4a
出力先を指定
{baseDir}/scripts/extract-audio.py video.mp4 -o ~/Music/my-song.mp3
YouTube 動画をダウンロード（保持する）
{baseDir}/scripts/extract-audio.py "https://youtube.com/watch?v=..." --video-only --keep-video
YouTube への対応
YouTube 動画の場合、可能であれば yt-dlp を使って音声を直接抽出します。動画全体をダウンロードするよりも高速で効率的です。
YouTube の制限事項
YouTube は自動ダウンロードを積極的にブロックしています。エラーが発生した場合は、次の方法をお試しください。
- yt-dlp を更新する：
pip3 install -U yt-dlp - 別の URL を試す — 一部の動画には、より厳しい制限があります
- --video-only を使用する：先に動画をダウンロードしてから、音声を抽出します
- ブラウザー拡張機能を使用する — YouTube ダウンローダー拡張機能でダウンロードしてから、ファイルを処理します
よくある YouTube エラー
- 403 Forbidden：YouTube がリクエストをブロックしました。yt-dlp を更新するか、別の動画をお試しください。
- サインインが必要：動画の視聴に認証が必要です。代わりにブラウザーでダウンロードしてください。
- タイムアウト：動画のサイズが大きすぎるか、接続が遅い可能性があります。先に
--video-onlyをお試しください。
技術的な詳細
- 音声抽出に ffmpeg を使用
- YouTube 動画のダウンロードに yt-dlp を使用
- 一時ディレクトリにダウンロードし、デフォルトで自動クリーンアップ
- 可能な場合は元の音声コーデックを維持
- 時間のかかる処理では進行状況を表示
コメント
Markdown 対応