# yt-dlp-kai v2.0.0 yt-dlp の GUI ラッパー。動画ダウンロード・字幕取得をダークUIから手軽に操作できる。 --- ## 必要なもの - Python 3.10 以上（Tkinter 同梱版） - `yt-dlp.exe` … 同じフォルダに配置（or PATH 上） - `ffmpeg.exe` … 同じフォルダに配置（フォーマット変換用） - `Node.js` … インストール推奨（YouTube Signature解決に必要） --- ## フォルダ構成 ``` yt-dlp-kai/ ├── yt-dlp-kai.py ← 本体 ├── yt-dlp-kai.vbs ← Windows 用ランチャー ├── yt-dlp.exe ← 別途用意 ├── ffmpeg.exe ← 別途用意 ├── cookies.txt ← 任意（Bot対策用） ├── config.ini ← 起動後に自動生成 └── yt-dlp-kai-error.log ← 起動エラー時のみ生成 ``` --- ## 起動方法 - **Windows**：`yt-dlp-kai.vbs` をダブルクリック（黒い窓が出ない） - **macOS / Linux**：`python3 yt-dlp-kai.py` --- ## タブ構成 ### ⬇ Download 1. URL をコピーして `Ctrl+V` で貼り付け → キューに追加 2. Format / Quality を選択 3. `Start Download` をクリック 複数URLの一括貼り付け・プレイリスト展開にも対応。 ### 💬 Subtitles 1. `Ctrl+V` でURLを貼り付け → 字幕リストを自動取得 2. フォーマット（lrc / txt 等）を選択 3. 言語を選んで `Preview`（サイドパネル表示）または `Download` - 検索ボックスでリアルタイム絞り込み（`ja`, `english` 等） - `自動翻訳` チェックで自動生成字幕も表示 ### ⚙ Settings | セクション | 主な項目 | |-----------|---------| | General | 保存先・Cookie・JSランタイム | | Download | ファイル名・埋め込み・フォーマット・Quality | | Subtitles | 表示フォーマット選択 | 設定は自動保存（`config.ini`）。 --- ## YouTubeのBot対策 ### 方法A：ブラウザCookieを使う（推奨） 1. Firefox で YouTube にログイン 2. Settings → Cookie ブラウザ で **Firefox** を選択 3. Settings → JS ランタイム で **node** を選択 > Chrome 127以降はApp-Bound Encryptionにより直接読み取り不可。Firefoxを推奨。 ### 方法B：cookies.txt を使う 1. Chrome拡張「Get cookies.txt LOCALLY」でYouTubeのCookieをエクスポート 2. `cookies.txt` にリネームして `yt-dlp.exe` と同じフォルダに配置 3. Settings → 「cookies.txt を使う」にチェック --- ## トラブルシューティング | 症状 | 対処 | |------|------| | 起動しない | `yt-dlp-kai-error.log` を確認 | | yt-dlp が見つからない | `yt-dlp.exe` を同フォルダに配置 | | ダウンロード失敗 | Bot対策設定を確認（上記参照） | | Signature solving failed | Node.js をインストールして JS ランタイムを `node` に | | Chrome Cookie エラー | Firefox または cookies.txt を使う | --- ## 更新履歴 ### v2.0.0 - Download・Subtitles を1つのアプリに統合 - Subtitles タブ追加（字幕取得・プレビュー・ダウンロード） - サイドパネルでの字幕プレビュー（lrc / txt / srt 等対応） - Settings をセクション分けしスクロール対応 - 字幕リストに検索ボックス追加 - 言語名の日本語表示対応 ### v1.1.0 - Quality 選択をプルダウンメニューに変更 - タイトル取得を高速化（oEmbed API 優先） ### v1.0.0 - 初版リリース --- ## exe 化（Windows） 1. エクスプローラーのアドレスバーに `cmd` と入力して Enter 2. 以下を実行（初回のみ）： ``` pip install pyinstaller ``` 3. 続けて以下を実行： ``` python -m PyInstaller --onefile --windowed --icon=icon.ico --name=yt-dlp-kai yt-dlp-kai.py ``` 4. 完了後、`dist` フォルダ内の `yt-dlp-kai.exe` を `yt-dlp.exe` / `ffmpeg.exe` と同じフォルダに置く。