youtube_downloader/
├── core/                     # 核心功能模組
│   ├── __init__.py           # 模組初始化檔案
│   ├── url_utils.py          # URL 處理工具
│   ├── download_engine.py    # 下載引擎抽象類
│   └── download_manager.py   # 下載管理器
├── ui/                       # 使用者介面模組
│   ├── __init__.py           # 模組初始化檔案
│   ├── base.py               # 基礎 UI 元件類別
│   ├── main_window.py        # 主視窗
│   ├── url_frame.py          # URL 輸入框架
│   ├── path_frame.py         # 下載位置選擇框架
│   ├── format_frame.py       # 下載格式選擇框架
│   ├── progress_frame.py     # 下載進度顯示框架
│   ├── output_frame.py       # 輸出文本框架
│   ├── quality_dialog.py     # 畫質選擇對話框
│   └── README.md             # UI 模組說明文件
├── utils/                    # 工具函數模組
│   └── __init__.py           # 模組初始化檔案
├── main.py                   # 程式入口
├── youtube_downloader.py     # 主程式（舊版）
├── requirements.txt          # 依賴項
└── README.md                 # 說明文件

1. URL 處理模組

   • 實現了 UrlProcessor 類別，提供完整的 URL 處理功能
   • 支援多種 URL 格式和平台 (YouTube, Bilibili)
   • 提供了 URL 清理、平台檢測、URL 驗證和影片 ID 提取功能

2. 下載引擎抽象化

   • 建立了抽象下載引擎基類 DownloadEngine
   • 實現了平台特定下載器 YouTubeDownloadEngine 和 BilibiliDownloadEngine
   • 創建了下載引擎工廠類 DownloadEngineFactory，自動選擇適合的下載器
   • 實現了下載管理器 DownloadManager，提供統一的下載介面

3. UI 元件分離 (已遷移至 PySide6)

   • 將大型 GUI 類拆分為多個專注的元件 (Qt 版本)
   • 實現了基礎 UI 元件類別 BaseFrame 和 BaseDialog (Qt 版本)
   • 創建了專注的 Qt UI 元件：URL 輸入、下載位置選擇、格式選擇、進度顯示、輸出日誌等
   • 實現了 macOS 風格的主題和樣式 (ThemeManager)
   • 整合所有元件到主視窗 MainWindow (Qt 版本)

4. 設定管理模組

   • 保存/載入使用者偏好設定
   • 記住上次的下載位置和格式選擇

5. 多語言支援

   • 提取文字字串到語言檔案
   • 實現多語言切換功能

6. 下載任務管理

   • 支援多任務並行下載
   • 實現暫停、繼續、取消等操作

# 下載 YouTube 視頻
ytdl https://www.youtube.com/watch?v=xxxxxxxxxxx

# 下載 Bilibili 視頻
ytdl https://www.bilibili.com/video/BVxxxxxxxxxx

# 指定輸出目錄
ytdl https://www.youtube.com/watch?v=xxxxxxxxxxx -o /path/to/downloads

# 下載純音訊 (MP3)
ytdl https://www.youtube.com/watch?v=xxxxxxxxxxx -f audio

# 指定視頻畫質 (例如 720p)
ytdl https://www.youtube.com/watch?v=xxxxxxxxxxx -q 720

# 批量下載（從文件讀取URL）
ytdl --batch urls.txt

# 啟動圖形界面
ytdl --gui

from youtube_downloader.downloader import simple_download

# 下載 YouTube 視頻
success, file_path, error = simple_download(
    url="https://www.youtube.com/watch?v=xxxxxxxxxxx",
    output_path="./downloads",
    format_choice="video",
    height=720  # 可選: 指定畫質
)

# 下載 Bilibili 視頻
success, file_path, error = simple_download(
    url="https://www.bilibili.com/video/BVxxxxxxxxxx",
    output_path="./downloads",
    format_choice="video",
    height=720  # 可選: 指定畫質
)

if success:
    print(f"下載成功: {file_path}")
else:
    print(f"下載失敗: {error}")

from youtube_downloader.downloader import DownloadManager

# 創建下載管理器（最多同時下載2個視頻）
manager = DownloadManager(max_concurrent=2)

# 添加下載任務
task_id = manager.add_task(
    url="https://www.youtube.com/watch?v=xxxxxxxxxxx",
    output_path="./downloads",
    format_choice="video"
)

# 啟動下載
manager.start()

# 獲取任務信息
task_info = manager.get_task(task_id)
print(f"下載進度: {task_info['progress']}%")

# 停止下載管理器
manager.stop()