ytd (Windows版)

yt-dlp のコマンドを短縮する CLI ツールです。長いオプションを覚えなくても、 よく使う操作を短いフラグで実行できます。

動作環境

• Windows 10 / 11
• Python 3.9+(インストール時に Add python.exe to PATH を必ずチェック)
• yt-dlp / ffmpeg(インストーラーが自動導入を試みます)

インストール

1. このzipを展開する

2. PowerShellで展開先フォルダに移動し、以下を実行

   powershell -ExecutionPolicy Bypass -File install.ps1

   これにより以下が行われます。

   • pip install yt-dlp pyyaml
   • winget install --id Gyan.FFmpeg -e(ffmpeg未導入かつwinget利用可能な場合)
   • %LOCALAPPDATA%\ytd へ本体を配置
   • ユーザー環境変数 PATH に自動追加
   • %USERPROFILE%\.config\ytd\config.yml を雛形から作成

3. 新しいターミナル(PowerShell または コマンドプロンプト)を開き直す(PATH反映のため)

インストール後は以下で確認できます。

ytd --help

基本的な使い方

ytd "VIDEO_URL"
ytd "VIDEO_URL" --option value

⚠ URLは必ずダブルクォートで囲んでください。 YouTubeのURLは &si=... のようなパラメータを含むことが多く、クオートを忘れると cmd.exe や PowerShell が & をコマンドの区切りと解釈し、後ろのオプションが 「認識されないコマンド」として無視されたり、意図しない動作になります。

使用例

ytd "VIDEO_URL"                                   最高画質・mp4で保存
ytd "VIDEO_URL" --quality 1080p                   1080pで保存
ytd "VIDEO_URL" --format mp3                      MP3に変換して保存
ytd "VIDEO_URL" --cookie                           Configの既定Cookieを使用
ytd "VIDEO_URL" --output C:\Users\YourName\Videos  保存先を指定
ytd "PLAYLIST_URL" --playlist                      プレイリスト全体を取得
ytd "VIDEO_URL" --info                             ダウンロードせず情報のみ表示

オプション一覧

オプション	説明
--format	出力形式(mp4, webm, mkv, mp3, m4a, aac, wav, flac, opus, ogg)
--quality	画質・音質(best, 2160p〜144p / 音声: 320k〜128k)
--cookie [PATH]	Cookie使用。パス省略時はConfigの既定Cookieを使用
--output PATH	保存先フォルダー
--playlist	プレイリスト全体を取得(未指定時は先頭1件のみ)
--audio	音声のみ取得
--video-only	映像のみ取得(音声なし)
--subtitle	字幕を保存
--embed-subtitle	字幕を動画に埋め込み
--thumbnail	サムネイルを保存
--embed-thumbnail	サムネイルを埋め込み
--metadata	メタデータを埋め込み
--archive / --no-archive	ダウンロード済み管理(既定: 有効)
--info	ダウンロードせず動画情報を表示
--list-format	利用可能フォーマット一覧を表示
--list-subtitle	利用可能字幕一覧を表示
--update	yt-dlp を更新
--help	ヘルプを表示

Config ファイル

%USERPROFILE%\.config\ytd\config.yml で既定値を変更できます。 優先順位は コマンドライン引数 > Config > デフォルト値 です。

cookie: C:\Users\YourName\Downloads\cookies.txt
output: C:\Users\YourName\Downloads
format: mp4
quality: best
playlist: false
embed_thumbnail: true
embed_metadata: true
filename_max_length: 120
archive: true

output / cookie は ~\Downloads のようなチルダ表記も使えます。

主な機能

• ファイル名自動短縮: タイトルが長い動画(filename_max_length 超)は 自動的に サイト名_動画ID.拡張子 で保存されます(例: Youtube_dQw4w9WgXcQ.mp4)。
• 重複ダウンロード確認: 同じ動画を再度ダウンロードしようとすると警告し、 Y/N で続行可否を確認します(--archive が有効な場合)。
• 多重起動防止: 同一URLに対して同時に複数の ytd が実行されるとファイル競合が 起きるため、実行中のプロセスがあれば新しい実行を拒否します。
• プレイリストURL誤爆防止: プレイリストのURL(list= を含む)なのに --playlist を付け忘れた場合、警告した上で先頭1件のみに制限します。

トラブルシューティング

'ytd' は、内部コマンドまたは外部コマンド...として認識されていません → install.ps1 実行後にターミナルを開き直していない可能性があります。新しいウィンドウで試してください。

✗ yt-dlp が見つかりません → pip install yt-dlp を実行してください。python コマンドがPATHに無い場合は Pythonの再インストール時に「Add python.exe to PATH」を有効にしてください。

⚠ ffmpeg が見つかりません → winget install --id Gyan.FFmpeg -e を実行するか、 gyan.dev から取得しPATHに追加してください。 動画の結合や音声変換ができないだけで、ダウンロード自体は動作する場合があります。

動画が途中で止まる・エラーで終わる → --update で yt-dlp を最新化してください(YouTube側の仕様変更に追従するため頻繁な更新が必要です)。

アンインストール

1. %LOCALAPPDATA%\ytd フォルダを削除
2. 環境変数 PATH から %LOCALAPPDATA%\ytd のエントリを削除(システムのプロパティ → 環境変数)
3. 必要であれば %USERPROFILE%\.config\ytd も削除(Config・ダウンロード履歴)