# vidFetch

**Repository Path**: tekintian/vidFetch

## Basic Information

- **Project Name**: vidFetch
- **Description**: 🎬 VidFetch - 万能视频下载器

一个功能强大、界面友好的跨平台视频下载工具，基于 yt-dlp 核心库，支持数千个网站的视频下载。
- **Primary Language**: Python
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: https://dev.tekin.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 视频下载, 下载, 视频, b站, 油管视频下载

## README

# 🎬 VidFetch - 万能视频下载器

一个功能强大、界面友好的跨平台视频下载工具，基于 yt-dlp 核心库，支持数千个网站的视频下载。

![VidFetch 界面预览](./docs/main.jpg)
![VidFetch 设置预览](./docs/settings.jpg)
![VidFetch 帮助预览](./docs/help.jpg)

---

## 🚀 主要特性

### 核心功能
- **支持数千个网站**：YouTube、Bilibili、Instagram、Twitter 等
- **多格式选择**：MP4、WebM、MP3、FLAC 等
- **画质选择**：支持 1080p、4K、8K 高清视频
- **批量下载**：支持多个视频同时下载
- **字幕下载**：自动检测并下载字幕
- **音频提取**：单独提取视频中的音频

### 界面特性
- **现代化界面**：基于 PyQt5 的直观用户界面
- **多语言支持**：中英文界面切换
- **实时进度**：下载进度实时显示
- **系统托盘**：支持最小化到系统托盘
- **暗黑模式**：支持深色主题

### 技术特性
- **跨平台**：支持 Windows、macOS、Linux
- **FFmpeg 集成**：自动检测和配置 FFmpeg
- **智能重试**：网络错误自动重试
- **代理支持**：支持 HTTP/SOCKS 代理
- **自定义配置**：丰富的配置选项

---

## 📦 支持的网站

### 主流平台
- **视频网站**：YouTube、Vimeo、Dailymotion、TikTok
- **社交媒体**：Instagram、Twitter、Facebook、LinkedIn
- **直播平台**：Twitch、Bilibili、Douyin、Kuaishou
- **教育平台**：Coursera、edX、Udemy
- **新闻网站**：CNN、BBC、Reuters

### 完整列表
支持超过 10,000+ 个网站，包括但不限于：
- 视频分享平台：YouTube、Vimeo、Dailymotion
- 社交媒体：Instagram、Twitter、Facebook、TikTok
- 直播平台：Twitch、Bilibili、Douyin
- 音乐平台：SoundCloud、Spotify、Apple Music
- 新闻网站：CNN、BBC、Reuters
- 教育平台：Coursera、edX、Udemy
- 体育平台：ESPN、NBA、NFL

---

## 🛠️ 安装方法

### 方法一：使用预编译安装包（推荐）

#### Windows
1. 下载 `VidFetch-Setup.exe` 安装包
2. 双击运行安装程序
3. 按照向导完成安装
4. 从开始菜单启动 VidFetch

#### macOS
1. 下载 `VidFetch.dmg` 镜像文件
2. 双击打开镜像
3. 将 VidFetch 拖放到 Applications 文件夹
4. 从 Launchpad 启动 VidFetch

#### Linux
1. 下载 `VidFetch.AppImage` 文件
2. 赋予执行权限：`chmod +x VidFetch.AppImage`
3. 双击运行 AppImage 文件

### 方法二：从源码运行

#### 1. 克隆项目
```bash
git clone https://github.com/tekintian/yt-dlp.git
cd yt-dlp
```

#### 2. 安装依赖
```bash
# 创建虚拟环境（推荐）
python3 -m venv venv

# 激活虚拟环境
# Windows: venv\Scripts\activate
# macOS/Linux: source venv/bin/activate

# 安装依赖
pip install -r requirements_gui.txt
```

#### 3. 运行应用
```bash
# Windows
./run_gui.bat

# macOS/Linux
./run_gui.sh
```

---

## 📖 使用指南

### 基本下载
1. **复制视频链接**：从浏览器复制视频 URL
2. **粘贴链接**：将链接粘贴到 VidFetch 的地址栏
3. **选择格式**：从下拉菜单选择视频格式和质量
4. **选择目录**：点击「浏览」选择保存目录
5. **开始下载**：点击「下载」按钮开始下载

### 高级功能

#### 批量下载
1. 点击「批量下载」按钮
2. 每行输入一个视频链接
3. 点击「开始批量下载」

#### 字幕下载
1. 在设置中启用「自动下载字幕」
2. 选择需要的字幕语言
3. 下载视频时会自动下载对应字幕

#### 音频提取
1. 在格式选择中选择音频格式（如 MP3、FLAC）
2. 点击「下载」按钮
3. 应用会自动提取音频并保存

### 快捷键
- **Ctrl+V**：粘贴链接
- **Ctrl+D**：开始下载
- **Ctrl+Q**：退出应用
- **F5**：刷新界面

---

## 🔧 构建指南

### 环境要求
- Python 3.10+
- PyQt5 >= 5.15.0
- PyInstaller >= 6.17.0
- FFmpeg（可选，用于视频转换）

### 构建步骤

#### Windows
```powershell
# 安装依赖
pip install -r requirements_gui.txt

# 构建应用
./build.ps1
```

#### macOS/Linux
```bash
# 安装依赖
pip install -r requirements_gui.txt

# 构建应用
./build.sh
```

构建产物会生成在 `dist/` 目录中。

---

## ⚙️ 配置说明

### 常规设置
- **默认下载目录**：设置视频保存位置
- **同时下载数**：设置最大并发下载数
- **自动开始下载**：粘贴链接后自动开始下载

### 网络设置
- **代理服务器**：设置 HTTP/SOCKS 代理
- **超时设置**：设置网络超时时间
- **重试次数**：设置网络错误重试次数

### FFmpeg 设置
- **自动检测**：自动检测系统中的 FFmpeg
- **手动设置**：手动指定 FFmpeg 可执行文件路径
- **自动下载**：自动下载和配置 FFmpeg

### 界面设置
- **语言**：选择界面语言（中文/英文）
- **主题**：选择界面主题（浅色/深色）
- **字体大小**：调整界面字体大小

---

## 🤝 贡献指南

### 开发环境搭建
1. 克隆项目：`git clone https://github.com/tekintian/yt-dlp.git`
2. 安装依赖：`pip install -r requirements_gui.txt`
3. 安装开发依赖：`pip install -r requirements_dev.txt`

### 代码规范
- 遵循 PEP 8 代码风格
- 使用类型提示
- 编写清晰的文档字符串
- 提交前运行测试：`pytest`

### 提交 PR
1. 创建分支：`git checkout -b feature/your-feature`
2. 提交更改：`git commit -m "Add your feature"`
3. 推送分支：`git push origin feature/your-feature`
4. 创建 Pull Request

---

## 📞 支持与反馈

### 常见问题

**Q: 下载失败怎么办？**
A: 检查网络连接，确保视频链接有效，尝试更换下载服务器。

**Q: 如何提高下载速度？**
A: 在设置中增加同时下载数，使用高速网络，关闭其他占用带宽的应用。

**Q: 支持哪些视频格式？**
A: 支持 MP4、WebM、FLV、3GP 等视频格式，以及 MP3、FLAC、AAC 等音频格式。

### 反馈渠道
- **GitHub Issues**：提交 bug 报告和功能请求
- **Email**：support@vidfetch.app
- **Discord**：加入 Discord 社区获取支持

---

## 📄 许可证

本项目基于 MIT 许可证开源：

```
MIT License

Copyright (c) 2026 Tekin.cn Team

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

---

## 🙏 致谢

### 核心依赖
- **[yt-dlp](https://github.com/yt-dlp/yt-dlp)**：强大的视频下载核心库
- **[PyQt5](https://www.riverbankcomputing.com/software/pyqt/)**：跨平台 GUI 框架
- **[FFmpeg](https://ffmpeg.org/)**：音视频处理工具

### 贡献者
感谢所有为 VidFetch 项目做出贡献的开发者和用户！

---

## 📞 联系方式

- **官方网站**：https://dev.tekin.cn
- **GitHub**：https://github.com/tekintian/yt-dlp
- **Gitee**：https://gitee.com/tekintian/yt-dlp
- **Twitter**：https://twitter.com/tekintian
- **Email**：support@tekin.cn

---

**✨ 感谢使用 VidFetch！如果您喜欢这个项目，请给我们一个 Star ⭐**