yt_dlp によるダウンロード

ダウンロードする際のコンテンツの利用条件はユーザで厳重に確認すること．違法なダウンロードは厳禁。

このツールの使用にあたっては、著作権法および関連法令を厳格に遵守する必要がある。動画のダウンロードは、著作権者が明示的に許可している場合、クリエイティブ・コモンズ等の適切なライセンスが付与されている場合、または著作権法上の例外規定に該当する場合にのみ実行すること。商用コンテンツ、有料配信コンテンツ、DRM（デジタル著作権管理）で保護されたコンテンツのダウンロードは違法行為となる可能性があるため，ダウンロードを試みることは、絶対に避けるべきである。教育・研究目的での使用においては、著作権法第35条等の関係法令を十分に確認すること。

ツール利用ガイド

1. このツールの利用シーン

このツールは、動画をローカルに保存するためのソフトウェアである。

2. 主な機能

動画ダウンロード: 動画サイトから動画を取得する
品質自動選択: 利用可能な品質を自動的に選択する
進捗表示: ダウンロード中の進捗率と転送速度をリアルタイムで表示する
フォーマット最適化: MP4形式を優先し、互換性の高いファイルを生成する
エラー処理: ダウンロード失敗時にエラー内容を表示する

3. 基本的な使い方

事前準備:
yt-dlpライブラリをインストールする（pip install yt-dlp）

4K/8K動画の場合はFFmpegをインストールする
プログラムの実行:
Pythonスクリプトを実行する

URLの入力を求められる
URLの入力:
動画のURLを貼り付けてEnterキーを押す

ダウンロードが自動的に開始される
完了確認:
「完了」メッセージが表示されたら、カレントディレクトリに動画ファイルが保存される

4. 便利な機能

プレイリスト対応: プレイリストURLを入力すると、全動画を順次ダウンロードする
品質指定: optionsのformat項目を変更することで、特定の解像度を指定できる
保存先指定: optionsに'outtmpl'項目を追加することで、保存先とファイル名を制御できる
字幕取得: 'writesubtitles': Trueを追加することで、利用可能な字幕も同時に取得する
音声のみ抽出: format指定を'bestaudio'に変更することで、音声ファイルのみを取得できる

ダウンロードする際のコンテンツの利用条件はユーザで厳重に確認すること．違法なダウンロードは厳禁です

Python開発環境，ライブラリ類

ここでは、最低限の事前準備について説明する。機械学習や深層学習を行う場合は、NVIDIA CUDA、Visual Studio、Cursorなどを追加でインストールすると便利である。これらについては別ページ https://www.kkaneko.jp/cc/dev/aiassist.htmlで詳しく解説しているので、必要に応じて参照してください。

Python 3.12 のインストール

インストール済みの場合は実行不要。

管理者権限でコマンドプロンプトを起動（手順：Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」）し、以下を実行する。管理者権限は、wingetの--scope machineオプションでシステム全体にソフトウェアをインストールするために必要である。

REM Python をシステム領域にインストール
winget install --scope machine --id Python.Python.3.12 -e --silent
REM Python のパス設定
set "PYTHON_PATH=C:\Program Files\Python312"
set "PYTHON_SCRIPTS_PATH=C:\Program Files\Python312\Scripts"
echo "%PATH%" | find /i "%PYTHON_PATH%" >nul
if errorlevel 1 setx PATH "%PATH%;%PYTHON_PATH%" /M >nul
echo "%PATH%" | find /i "%PYTHON_SCRIPTS_PATH%" >nul
if errorlevel 1 setx PATH "%PATH%;%PYTHON_SCRIPTS_PATH%" /M >nul

【関連する外部ページ】

Python の公式ページ: https://www.python.org/

AI エディタ Windsurf のインストール

Pythonプログラムの編集・実行には、AI エディタの利用を推奨する。ここでは，Windsurfのインストールを説明する。

管理者権限でコマンドプロンプトを起動（手順：Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」）し、以下を実行して、Windsurfをシステム全体にインストールする。管理者権限は、wingetの--scope machineオプションでシステム全体にソフトウェアをインストールするために必要となる。

winget install --scope machine Codeium.Windsurf -e --silent

【関連する外部ページ】

Windsurf の公式ページ: https://windsurf.com/

Windows での FFmpeg インストール手順（手動インストール）

公式ビルド版を使用

ダウンロード
1. https://www.gyan.dev/ffmpeg/builds/ にアクセス
2. 「release builds」セクションの「full」版をダウンロード
  - ファイル名例: ffmpeg-release-full.7z
  - essentials版ではなくfull版を選択（ffprobeも含まれる）
解凍
1. ダウンロードした7zファイルを右クリック
2. 7-Zip等で解凍（Windows標準では7z非対応のため、7-Zipが必要）
  - 7-Zipダウンロード: https://www.7-zip.org/
3. 解凍先を C:\ffmpeg にする（推奨）
  - フォルダ構造: C:\ffmpeg\bin\ffmpeg.exe となるように配置
環境変数PATHの設定
1. Windowsキー + R → 「sysdm.cpl」と入力してEnter
2. 「詳細設定」タブ → 「環境変数」ボタンをクリック
3. 「システム環境変数」の「Path」を選択 → 「編集」
4. 「新規」をクリック → C:\ffmpeg\bin を追加
5. 「OK」を3回クリックして設定を保存
動作確認
1. コマンドプロンプトを新規で開く（既存のものは閉じる）
2. 以下のコマンドを実行：
```
ffmpeg -version
ffprobe -version
```
3. バージョン情報が表示されれば成功

必要なライブラリのインストール

コマンドプロンプトを管理者として実行（手順：Windowsキーまたはスタートメニュー > cmd と入力 > 右クリック > 「管理者として実行」）し、以下を実行する


pip install yt-dlp

yt_dlp によるダウンロードプログラム

概要

このプログラムは、動画配信サイトから動画ファイルをダウンロードする。yt-dlpライブラリ[1]を使用。

主要技術

yt-dlp

youtube-dlから派生した動画ダウンロードライブラリである[1]。600以上の動画サイトに対応し、プレイリスト処理、字幕ダウンロード、メタデータ抽出などの機能を提供する。フォーマット選択アルゴリズムにより、利用可能な品質の動画を自動選択する[3]。

FFmpeg

動画・音声の変換処理を行うマルチメディアフレームワークである[2]。4K/8K動画の処理や、映像と音声の結合処理で使用される。yt-dlpと連携して、ダウンロード後の動画処理を実行する。

実装の特色

フォーマット選択式による最適品質の自動選択

MP4形式を優先したフォーマット指定。このプログラムは、'best[ext=mp4]/bestvideo[ext=mp4]+bestaudio[ext=m4a]/best'という指定により、MP4形式を優先しつつ、利用可能な最高品質を選択する[3]。

progress_hooks機能により、ダウンロード中の進捗率と転送速度をリアルタイムで表示する。

参考文献

[1] yt-dlp Development Team. (2024). yt-dlp: A feature-rich command-line audio/video downloader. GitHub. https://github.com/yt-dlp/yt-dlp

[2] FFmpeg Developers. (2024). FFmpeg Documentation. https://ffmpeg.org/documentation.html

[3] Pukkandan et al. (2024). yt-dlp Documentation - Format Selection. https://github.com/yt-dlp/yt-dlp#format-selection

ソースコード


# FFmpeg（4K/8K品質には必須）
# Windows: https://ffmpeg.org/download.html からダウンロード

import yt_dlp

def download_with_progress(url):
    def progress_hook(d):
        if d['status'] == 'downloading':
            print(f"\r進行状況: {d.get('_percent_str', '0%')} "
                  f"速度: {d.get('_speed_str', '0B/s')}", end='')

    options = {
        'format': 'best[ext=mp4]/bestvideo[ext=mp4]+bestaudio[ext=m4a]/best',
        'progress_hooks': [progress_hook],
        'writeinfojson': False,
    }

    with yt_dlp.YoutubeDL(options) as ydl:
        try:
            ydl.download([url])
            print("\n完了")
        except Exception as e:
            print(f"\nエラー: {e}")

# 使用
url = input("URL: ")
download_with_progress(url)