This YouTube Downloader is a Python-based GUI application that allows users to download YouTube videos in various resolutions and optionally with subtitles. It utilizes the yt-dlp library for downloading videos and ffmpeg for processing videos that require merging separate audio and video streams.
- Download videos in various resolutions with estimated file size display
- Support for downloading subtitles
- Progress tracking with elapsed time display
- Download cancellation support
- Proxy settings support
- Clipboard URL detection - paste URL on focus/click
- Cross-platform GUI created with
tkinterandttkbootstrap - Automatic download folder opening after download completes
- Python 3.x (only for running from source)
- ffmpeg (for merging audio and video streams)
- Node.js (LTS recommended) — required by current YouTube's SABR streaming experiment to solve the
nchallenge - bgutil-ytdlp-pot-provider + its HTTP server — required to bypass the 2026-08-17 YouTube change that 403's all anonymous HTTPS downloads
- Required Python packages (see requirements.txt)
- Install Python on your system
- Install Node.js: download from https://nodejs.org/ or run
winget install OpenJS.NodeJS - Install ffmpeg:
- Windows: Download from https://ffmpeg.org/ and add to PATH
- macOS:
brew install ffmpeg - Linux:
sudo apt install ffmpegor your distro's package manager
- Install Python dependencies:
pip install -r requirements.txt
- Install and run the bgutil POT HTTP server (port 4416 by default). Easiest with Docker:
docker run --name bgutil-provider -d -p 4416:4416 --init brainicism/bgutil-ytdlp-pot-provider
Or from source: clone https://github.com/Brainicism/bgutil-ytdlp-pot-provider, then cd server && npm install && npx tsx src/main.ts. Leave the terminal open while downloading.
Pre-built
youtubeVideoDownloader.exeusers only need steps 2, 3, 5 — Python dependencies and the bgutil plugin are bundled.
- Start the application
- Enter the YouTube video URL in the provided field (or paste from clipboard by clicking the input field)
- Click "加载视频信息" (Load Video Info) to fetch video details
- Select the desired video resolution and subtitle language (if needed)
- Choose the download path by clicking "下载路径" (Download Path)
- Click "开始下载" (Start Download) to begin downloading
- Click "取消下载" (Cancel Download) to stop an ongoing download
YouTube has been rolling out a SABR-only streaming experiment to anonymous users since 2026. As a result, anonymous downloads are typically capped at 360p. To download 1080p or higher:
- Log in to YouTube in your browser, then export your cookies using a "Get cookies.txt LOCALLY" extension and load them via 设置 → Cookies 文件.
The app will pop up a one-time warning at startup if Node.js is not detected on your PATH.
- 设置 (Settings) > 代理设置 (Proxy Settings): Configure proxy server
- 设置 (Settings) > 关于 (About): Application information
Contributions to improve the application or add new features are welcome. Please fork the repository, make your changes, and submit a pull request.
This project is licensed under the MIT License.
This tool is for educational and research purposes only, do not use it for any illegal purposes. Downloading videos using this tool may violate YouTube's Terms of Service, use it at your own risk.
这个YouTube视频下载器是一个基于Python的GUI应用程序,允许用户下载各种分辨率的YouTube视频,并可选下载字幕。它使用了yt-dlp库来下载视频,以及ffmpeg来处理需要合并音频和视频流的视频。
- 支持下载各种分辨率的视频,并显示预估文件大小
- 支持下载字幕
- 进度跟踪和已用时间显示
- 支持取消下载
- 代理设置功能
- 剪贴板URL检测 - 点击输入框时自动粘贴URL
- 使用
tkinter和ttkbootstrap创建的跨平台GUI - 下载完成后自动打开下载文件夹
- Python 3.x
- ffmpeg (用于合并音频和视频流)
- Python依赖包 (见 requirements.txt)
- 在系统上安装Python
- 安装ffmpeg:
- Windows: 从 https://ffmpeg.org/ 下载并添加到PATH
- macOS:
brew install ffmpeg - Linux:
sudo apt install ffmpeg或对应发行版的包管理器
- 安装Python依赖:
pip install -r requirements.txt
- 启动应用程序
- 在输入框中输入YouTube视频URL (或点击输入框从剪贴板粘贴)
- 点击"加载视频信息"获取视频详情
- 选择所需的视频分辨率和字幕语言(如需要)
- 点击"下载路径"选择下载保存位置
- 点击"开始下载"开始下载视频
- 点击"取消下载"可停止正在下载的任务
- 设置 > 代理设置: 配置代理服务器
- 设置 > 关于: 查看应用程序信息
欢迎贡献以改进应用程序或添加新功能。请fork仓库,进行更改,并提交拉取请求。
该项目在MIT许可下授权。
本工具仅供学习和研究目的,请勿用于任何非法目的。使用本工具下载视频可能违反YouTube的服务条款,请自行承担相应的法律责任。