一個基於 Python 與 CustomTkinter 開發的現代化 YouTube 下載工具，支援高畫質影片下載、雙語字幕合併、以及 AI 羅馬拼音標註。
- 多畫質選擇: 支援 1080p、4K 等高解析度下載
- 自動音訊合併: 高畫質影片自動與最佳音訊軌合併 (需 FFmpeg)
- 批量下載: 一次貼上多個網址，自動依序處理
- 多語言字幕下載: 支援繁體中文、簡體中文、英文、日文
- 日中雙語字幕: 自動合併日文與中文字幕，方便日語學習
- AI 羅馬拼音 (可選): 使用 DeepSeek AI 自動為日文歌詞標註羅馬拼音
- 黑底風格的 GUI (CustomTkinter)
- 即時下載進度顯示
- 詳細日誌輸出
- Python 3.10+: 下載 Python (安裝時請勾選 "Add Python to PATH")
-
下載本專案
git clone https://github.com/YOUR_USERNAME/YT-Downloader.git cd YT-Downloader -
(可選) 設定 AI 羅馬拼音功能
如果您想使用「AI 羅馬拼音」功能，請：
- 複製
config.example.py並重命名為config.py - 編輯
config.py，填入您的 DeepSeek API Key
# config.py DEEPSEEK_API_KEY = "sk-xxxxxxxxxxxxxxxxxxxxxxxx"
免費額度: DeepSeek 提供免費 API 額度，足夠一般使用。
- 複製
-
一鍵啟動
雙擊執行
start.bat，程式會自動：- 建立虛擬環境
- 安裝所有依賴套件
- 下載並設定 FFmpeg (如果未安裝)
- 啟動應用程式
- 複製 YouTube 影片網址
- 貼上至「單一影片」頁籤的輸入框
- 點擊「分析影片」
- 選擇想要的畫質
- (可選) 勾選「下載字幕」與選擇語言
- 點擊「開始下載」
- 切換至「批量下載」頁籤
- 每行貼上一個 YouTube 網址
- 選擇字幕設定
- 點擊「開始批量下載」
- 選擇「日中雙語 (合併顯示)」
- 勾選「AI 羅馬拼音」
- 下載後的字幕將同時顯示：
- 日文原文
- 羅馬拼音 (AI 生成)
- 中文翻譯
YT-Downloader/
├── main.py # 主程式 (GUI)
├── core.py # 核心邏輯 (下載、字幕處理)
├── config.example.py # 設定檔範例 (需複製為 config.py)
├── config.py # 您的設定檔 (Git 忽略)
├── requirements.txt # Python 依賴清單
├── start.bat # Windows 一鍵啟動腳本
└── README.md # 本說明文件
如果您不想使用 start.bat，可以手動設定環境：
# 建立虛擬環境
python -m venv .venv
# 啟用虛擬環境
.\.venv\Scripts\activate # Windows
source .venv/bin/activate # Linux/Mac
# 安裝依賴
pip install -r requirements.txt
# 執行程式
python main.py| 技術 | 用途 |
|---|---|
| yt-dlp | YouTube 影片下載核心 |
| CustomTkinter | 現代化 GUI 框架 |
| Pillow | 影像處理 (縮圖顯示) |
| OpenAI SDK | DeepSeek API 串接 (AI 羅馬拼音) |
| FFmpeg | 影音處理 (音訊合併、字幕嵌入) |
A: YouTube 的高畫質串流是影像與音訊分離的。本程式需要 FFmpeg 來合併它們。start.bat 會自動下載 FFmpeg，如果仍有問題，請確認 ffmpeg.exe 在程式目錄內。
A: 請確認：
- 已建立
config.py並填入有效的 DeepSeek API Key - 已安裝
openai套件 (pip install openai) - 網路連線正常
A:
- 檢查網址是否正確
- 嘗試更新 yt-dlp:
pip install -U yt-dlp - 某些地區可能需要 VPN
本專案採用 MIT License 授權。
- yt-dlp - 強大的影片下載引擎
- CustomTkinter - 現代化的 Tkinter 主題
- DeepSeek - AI 羅馬拼音功能的 API 支援