youtube-downloader

YouTube 動画ダウンローダー

品質や形式の設定を細かく指定して、YouTube 動画をダウンロードします。

クイックスタート

動画をダウンロードする最も簡単な方法：

python scripts/download_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

これにより、利用可能な最高品質の動画が MP4 形式で /mnt/user-data/outputs/ にダウンロードされます。

オプション

品質設定

-q または --quality を使って動画の品質を指定します：

• best（デフォルト）：利用可能な最高品質
• 1080p：フル HD
• 720p：HD
• 480p：標準画質
• 360p：低画質
• worst：利用可能な最低品質

例：

python scripts/download_video.py "URL" -q 720p

形式オプション

-f または --format を使って出力形式を指定します（動画のダウンロードのみ）：

• mp4（デフォルト）：最も互換性の高い形式
• webm：最新の形式
• mkv：Matroska コンテナ

例：

python scripts/download_video.py "URL" -f webm

音声のみ

-a または --audio-only を使って、音声のみを MP3 形式でダウンロードします：

python scripts/download_video.py "URL" -a

出力先ディレクトリの指定

-o または --output を使って、別の出力先ディレクトリを指定します：

python scripts/download_video.py "URL" -o /path/to/directory

使用例

1. 動画を 1080p の MP4 形式でダウンロード：

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 1080p

2. 音声のみを MP3 形式でダウンロード：

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -a

3. 動画を 720p の WebM 形式で、指定したディレクトリにダウンロード：

python scripts/download_video.py "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -q 720p -f webm -o /custom/path

動作の仕組み

このスキルでは、堅牢な YouTube ダウンローダーである yt-dlp を使用します。次の機能があります：

• 見つからない場合は自動的にインストールします
• ダウンロード前に動画情報を取得します
• 指定した条件に合う最適なストリームを選択します
• 必要に応じて動画ストリームと音声ストリームを結合します
• 幅広い YouTube 動画形式に対応しています

重要な注意事項

• ダウンロードしたファイルは、デフォルトで /mnt/user-data/outputs/ に保存されます
• 動画のタイトルからファイル名が自動的に生成されます
• スクリプトが yt-dlp のインストールを自動的に処理します
• ダウンロードされるのは単一の動画のみです（デフォルトではプレイリストはスキップされます）
• 高画質の動画は、ダウンロードに時間がかかり、ディスク容量を多く使用する場合があります