ui-for-yt-dlp

一套以 PowerShell 打造、輕量的 yt-dlp 圖形化介面。將最常用的下載選項包裝成簡單的視窗介面，讓你不需要碰命令列也能輕鬆下載音訊或影片。

• 功能特色
• 系統需求
• 安裝方式
• 使用說明
• 輸出結構
• 疑難排解
• 致謝

• 兩種下載模式 — 透過下拉選單切換 音訊 或 影片。
• 音訊格式 — 可選擇 flac、wav 或 mp3。
• 影片容器 — 可選擇 mp4、mkv、webm、avi、wmv 或 mov。
• 字幕嵌入 — 可指定字幕語言（預設 zh-Hant,en），並直接嵌入影片檔案中。
• 多執行緒下載 — 可設定同時下載片段數，從 0（單執行緒）到 16，建議使用 4–8。
• 播放清單支援 — 自動偵測播放清單網址，依清單分類資料夾並以編號命名檔案。
• 選擇性嵌入 — 可嵌入縮圖與中繼資料至輸出檔案。
• 略過 SSL 檢查 — 遇到憑證問題時可選擇略過。
• 直接寫入模式 — 避免下載過程中產生 .part 暫存檔。
• 即時日誌 — 內建輸出面板會顯示完整的 yt-dlp 指令與即時進度。
• 停止按鈕 — 可隨時安全地中止正在進行的下載。

1. Windows（本介面採用 Windows Forms / PowerShell 打造）。
2. PowerShell 5.1 或更新版本（Windows 10/11 內建）。
3. yt-dlp — 以下任一方式：
   • 將 yt-dlp.exe 放在與腳本相同的資料夾，或
   • 安裝於系統中並加入 PATH 環境變數。
4. Deno（可選但建議）— 腳本會傳入 --js-runtimes deno 參數以啟用 JavaScript 執行環境支援。

1. 複製專案

   git clone https://github.com/999jjkl/ui-for-yt-dlp.git
   cd ui-for-yt-dlp
   

2.將 yt-dlp.exe 放入專案資料夾（或確保它已在 PATH 中）。

3.啟動程式

直接雙擊 dl_GUI.bat。此批次檔會以隱藏視窗啟動 PowerShell 並載入 yt-dlp-gui-zhtw.ps1。

或者也可以直接執行 PowerShell 腳本：powershell -NoProfile -ExecutionPolicy Bypass -File .\yt-dlp-gui-zhtw.ps1

輸出結構

依模式不同，下載檔案會存放到兩個上層資料夾： 模式 資料夾 播放清單行為 音訊 OST/ OST/<播放清單標題>/01 - <標題>.ext 影片 VIDEO/ VIDEO/<播放清單標題>/01 - <標題>.ext

若為單一影片，檔名即為 <標題>.ext

使用說明

1.選擇模式 — 從「下載模式」下拉選單中選擇 音訊 或 影片。

2.選擇格式 — 格式清單會自動更新：

音訊：flac、wav、mp3

影片：mp4、mkv、webm、avi、wmv、mov

3.輸入網址 — 將影片或播放清單網址貼到「網址」欄位。

4.調整選項（可選）：

-同時下載數 — 0 為單執行緒，建議 4–8。

-略過 SSL 憑證檢查 — 遇到憑證錯誤時勾選。

-嵌入縮圖與中繼資料 — 預設為勾選。

-直接寫入模式 — 避免產生 .part 暫存檔。

5.點擊「開始下載」。日誌面板會顯示完整指令與即時輸出。

6.點擊「停止下載」 可中止下載。

疑難排解

「找不到 yt-dlp！」 請確認 yt-dlp.exe 與腳本位於同一資料夾，或已安裝至系統並加入 PATH。

視窗一閃即關 請從終端機執行 dl_GUI.bat，而非直接雙擊，才能看到錯誤訊息。批次檔預設會隱藏 PowerShell 視窗。

下載時發生 SSL 憑證錯誤 勾選「略過 SSL 憑證檢查」選項。

播放清單沒有被分類 腳本會偵測網址中是否包含 list=。請確認播放清單網址中包含此參數。

致謝

-yt-dlp — 本介面所包裝的強大下載工具。