使用 Python 构建视频下载器（和 yt-dlp）

原创

已于 2025-10-08 08:22:19 修改 · 992 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#python #音视频 #yt #dlp

于 2025-10-08 08:00:07 首次发布

项目概述

本文将详细解析一个基于 Python 的视频下载器的实现。该程序使用 wxPython 构建图形界面，通过 yt-dlp 实现视频下载功能，支持视频和纯音频下载，并提供实时进度显示。
C:\pythoncode\new\yt_downloader.py

技术栈

wxPython：跨平台的 GUI 工具包，用于构建用户界面
yt-dlp：视频下载库，youtube-dl 的增强版本
threading：Python 多线程模块，用于异步下载
FFmpeg：音视频处理工具（用于音频提取）

核心架构分析

1. 导入依赖与错误处理

import wx
import os
import sys
import subprocess
import threading
from pathlib import Path

try:
    from yt_dlp import YoutubeDL
except ImportError:
    print("请先安装 yt-dlp: pip install yt-dlp")
    sys.exit(1)

设计要点：

使用 try-except 捕获导入错误，提供友好的安装提示
使用 Path 对象处理文件路径，提高跨平台兼容性
subprocess 用于打开文件管理器

2. 下载线程类（DownloadThread）

这是程序的核心下载逻辑，继承自 threading.Thread。

2.1 初始化方法

def __init__(self, parent, url, audio_only, download_path):
    threading.Thread.__init__(self)
    self.parent = parent
    self.url = url
    self.audio_only = audio_only
    self.download_path = download_path
    self.daemon = True

关键设计：

daemon = True：设置为守护线程，主程序退出时线程自动结束
parent 引用：保持对主窗口的引用，用于回调更新 UI
参数传递：封装下载所需的所有配置

2.2 下载执行方法（run）

def run(self):
    try:
        ydl_opts = {
   
   
            'outtmpl': os.path.join(self.download_path, '%(title)s.%(ext)s'),
            'progress_hooks': [self.progress_hook],
            'quiet': False,
            'no_warnings': False,
            'extractor_args': {
   
   'youtube': {
   
   'player_client': ['android', 'web']}},
        }

配置详解：

outtmpl：输出文件命名模板
- %(title)s：视频标题
- %(ext)s：文件扩展名
- 自动使用视频标题作为文件名
progress_hooks：进度回调函数列表
- 下载过程中持续调用，用于更新进度条
extractor_args：提取器参数
- 指定使用 Android 和 Web 客户端
- 绕过 YouTube 的某些限制（如 SSAP 广告实验）

2.3 音频/视频模式配置

if self.audio_only:
    ydl_opts.update({
   
   
        'format': 'bestaudio/best',
        'postprocessors': [{
   
   
            'key': 'FFmpegExtractAudio',
            'preferredcodec': 'mp3',
            'preferredquality': '192',
        }],
        'prefer_ffmpeg': True