docs: Add comprehensive feature list
This commit is contained in:
236
README.md
236
README.md
@@ -1,15 +1,106 @@
|
|||||||
# 抖音去水印下载器 v3.0
|
# 抖音去水印下载器 v3.0
|
||||||
|
|
||||||
自动Cookie | 无需登录 | 一键下载 | 支持多环境
|
自动Cookie | 无需登录 | 一键下载 | 支持多环境 | 功能丰富
|
||||||
|
|
||||||
## ✨ 特性
|
## ✨ 核心特性
|
||||||
|
|
||||||
- ✅ **自动Cookie获取** - 无需手动操作
|
- ✅ **自动Cookie获取** - 无需手动操作
|
||||||
- ✅ **多浏览器支持** - Edge/Chrome/Firefox
|
- ✅ **多浏览器支持** - Edge/Chrome/Firefox
|
||||||
- ✅ **HTTP请求方式** - 无浏览器也能用
|
- ✅ **HTTP请求方式** - 无浏览器也能用
|
||||||
- ✅ **GUI界面** - 简单易用
|
- ✅ **GUI界面** - 简单易用
|
||||||
- ✅ **无水印下载** - 高清原画
|
- ✅ **无水印下载** - 高清原画
|
||||||
- ✅ **多模式下载** - 单个/主页/喜欢/收藏等
|
- ✅ **功能丰富** - 支持多种下载模式
|
||||||
|
|
||||||
|
## 🎯 完整功能列表
|
||||||
|
|
||||||
|
### 📥 下载模式(9种)
|
||||||
|
|
||||||
|
1. **单个作品** (one)
|
||||||
|
- 下载单个视频/图集
|
||||||
|
- 支持分享链接
|
||||||
|
|
||||||
|
2. **用户主页** (post)
|
||||||
|
- 批量下载用户发布作品
|
||||||
|
- 支持时间范围筛选
|
||||||
|
|
||||||
|
3. **用户喜欢** (like)
|
||||||
|
- 下载用户点赞作品
|
||||||
|
- 需要登录Cookie
|
||||||
|
|
||||||
|
4. **用户收藏** (collection)
|
||||||
|
- 下载用户收藏作品
|
||||||
|
- 需要登录Cookie
|
||||||
|
|
||||||
|
5. **收藏合集** (collects)
|
||||||
|
- 下载用户创建的合集
|
||||||
|
- 需要登录Cookie
|
||||||
|
|
||||||
|
6. **收藏音乐** (music)
|
||||||
|
- 下载收藏的音乐
|
||||||
|
- 保存背景音乐
|
||||||
|
|
||||||
|
7. **合集作品** (mix)
|
||||||
|
- 下载视频合集
|
||||||
|
- 批量下载
|
||||||
|
|
||||||
|
8. **直播录制** (live)
|
||||||
|
- 录制直播间
|
||||||
|
- 实时保存
|
||||||
|
|
||||||
|
9. **相关推荐** (related)
|
||||||
|
- 下载推荐视频
|
||||||
|
- 发现更多内容
|
||||||
|
|
||||||
|
### 🎵 媒体下载选项
|
||||||
|
|
||||||
|
- **视频** - 无水印高清视频
|
||||||
|
- **原声** - 视频背景音乐(MP3)
|
||||||
|
- **封面** - 视频封面图片
|
||||||
|
- **文案** - 视频描述文字
|
||||||
|
- **歌词** - 原声歌词(LRC格式)
|
||||||
|
|
||||||
|
### ⚙️ 高级功能
|
||||||
|
|
||||||
|
- **时间筛选** - 指定日期范围下载
|
||||||
|
```
|
||||||
|
格式:YYYY-MM-DD|YYYY-MM-DD 或 'all'
|
||||||
|
示例:2024-01-01|2024-12-31
|
||||||
|
```
|
||||||
|
|
||||||
|
- **数量限制** - 控制下载数量
|
||||||
|
```
|
||||||
|
0 = 全部下载
|
||||||
|
N = 只下载前N个
|
||||||
|
```
|
||||||
|
|
||||||
|
- **自定义命名** - 文件名格式
|
||||||
|
- 支持多种变量
|
||||||
|
- 自动去重
|
||||||
|
|
||||||
|
- **代理设置** - 支持HTTP/HTTPS代理
|
||||||
|
```
|
||||||
|
示例:http://127.0.0.1:7890
|
||||||
|
```
|
||||||
|
|
||||||
|
- **并发控制** - 调整下载速度
|
||||||
|
- 最大并发连接数
|
||||||
|
- 最大任务数
|
||||||
|
- 超时重试
|
||||||
|
|
||||||
|
- **自动重试** - 网络错误自动重试
|
||||||
|
- 失败后自动重试
|
||||||
|
- 可设置重试次数
|
||||||
|
|
||||||
|
- **进度显示** - 实时下载进度
|
||||||
|
- 日志输出
|
||||||
|
- 进度条
|
||||||
|
|
||||||
|
### 🔧 Cookie管理
|
||||||
|
|
||||||
|
- **自动获取** - 浏览器/HTTP方式
|
||||||
|
- **自动保存** - 本地文件存储
|
||||||
|
- **自动刷新** - 过期自动更新
|
||||||
|
- **手动输入** - 支持手动配置
|
||||||
|
|
||||||
## 🚀 快速开始
|
## 🚀 快速开始
|
||||||
|
|
||||||
@@ -25,6 +116,25 @@
|
|||||||
"C:\Program Files\Python311\python.exe" douyin_ui.py
|
"C:\Program Files\Python311\python.exe" douyin_ui.py
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 方式3:命令行下载(高级)
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 下载单个视频
|
||||||
|
python -m f2 dy -M one -u "分享链接"
|
||||||
|
|
||||||
|
# 下载用户主页全部作品
|
||||||
|
python -m f2 dy -M post -u "主页链接"
|
||||||
|
|
||||||
|
# 下载用户喜欢(需要Cookie)
|
||||||
|
python -m f2 dy -M like -u "主页链接" -k "cookie"
|
||||||
|
|
||||||
|
# 下载指定时间范围
|
||||||
|
python -m f2 dy -M post -u "主页链接" -i "2024-01-01|2024-12-31"
|
||||||
|
|
||||||
|
# 只下载前10个作品
|
||||||
|
python -m f2 dy -M post -u "主页链接" -o 10
|
||||||
|
```
|
||||||
|
|
||||||
## 📋 系统要求
|
## 📋 系统要求
|
||||||
|
|
||||||
- **Python** 3.11+
|
- **Python** 3.11+
|
||||||
@@ -34,28 +144,29 @@
|
|||||||
- Mozilla Firefox
|
- Mozilla Firefox
|
||||||
- **网络** - 能访问 www.douyin.com
|
- **网络** - 能访问 www.douyin.com
|
||||||
|
|
||||||
## 🎯 使用方法
|
## 🎯 使用场景
|
||||||
|
|
||||||
1. **粘贴链接** - 复制抖音分享链接到输入框
|
### 个人使用
|
||||||
2. **点击下载** - 自动获取Cookie并下载
|
- 保存喜欢的视频
|
||||||
3. **完成** - 视频保存在下载目录
|
- 备份自己的作品
|
||||||
|
- 收藏音乐和文案
|
||||||
|
|
||||||
## 🔄 Cookie自动获取机制
|
### 内容创作
|
||||||
|
- 素材收集
|
||||||
|
- 视频分析
|
||||||
|
- 灵感参考
|
||||||
|
|
||||||
程序会自动尝试以下方式获取Cookie:
|
### 数据分析
|
||||||
|
- 批量采集
|
||||||
1. **Edge浏览器**(优先)
|
- 数据备份
|
||||||
2. **Chrome浏览器**(备选)
|
- 趋势研究
|
||||||
3. **Firefox浏览器**(备选)
|
|
||||||
4. **HTTP请求**(无浏览器时)
|
|
||||||
5. **手动输入**(最后备选)
|
|
||||||
|
|
||||||
## 📦 依赖安装
|
## 📦 依赖安装
|
||||||
|
|
||||||
首次运行会自动安装:
|
首次运行会自动安装:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install selenium webdriver-manager requests
|
pip install selenium webdriver-manager requests f2
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🌍 环境兼容性
|
## 🌍 环境兼容性
|
||||||
@@ -74,21 +185,33 @@ pip install selenium webdriver-manager requests
|
|||||||
|
|
||||||
(使用HTTP请求方式获取Cookie)
|
(使用HTTP请求方式获取Cookie)
|
||||||
|
|
||||||
## 🎨 功能说明
|
## 🎨 使用技巧
|
||||||
|
|
||||||
### 下载模式
|
### 1. 批量下载
|
||||||
|
```
|
||||||
|
模式:用户主页
|
||||||
|
链接:用户主页分享链接
|
||||||
|
数量:0(全部)
|
||||||
|
```
|
||||||
|
|
||||||
- **单个作品** - 下载单个视频
|
### 2. 定期备份
|
||||||
- **用户主页** - 批量下载用户发布作品
|
```
|
||||||
- **用户喜欢** - 下载用户点赞作品
|
模式:用户主页
|
||||||
- **用户收藏** - 下载用户收藏作品
|
链接:自己的主页
|
||||||
- **直播** - 录制直播间
|
时间:2024-01-01|2024-12-31
|
||||||
|
```
|
||||||
|
|
||||||
### 高级选项
|
### 3. 音乐收藏
|
||||||
|
```
|
||||||
|
模式:收藏音乐
|
||||||
|
选项:下载原声 ✓
|
||||||
|
```
|
||||||
|
|
||||||
- **下载原声** - 保存视频背景音乐
|
### 4. 代理加速
|
||||||
- **下载封面** - 保存视频封面图片
|
```
|
||||||
- **作品数量** - 限制下载数量(0=全部)
|
设置:HTTP代理
|
||||||
|
地址:http://127.0.0.1:7890
|
||||||
|
```
|
||||||
|
|
||||||
## 🔧 技术栈
|
## 🔧 技术栈
|
||||||
|
|
||||||
@@ -97,26 +220,52 @@ pip install selenium webdriver-manager requests
|
|||||||
- **f2** - 抖音API库
|
- **f2** - 抖音API库
|
||||||
- **tkinter** - GUI界面
|
- **tkinter** - GUI界面
|
||||||
- **requests** - HTTP请求
|
- **requests** - HTTP请求
|
||||||
|
- **asyncio** - 异步下载
|
||||||
|
|
||||||
## 📝 工作原理
|
## 📝 工作原理
|
||||||
|
|
||||||
1. **自动Cookie**
|
### 1. Cookie获取
|
||||||
```
|
```
|
||||||
Selenium启动浏览器 → 访问抖音 → 提取Cookie
|
Selenium启动浏览器 → 访问抖音 → 提取Cookie
|
||||||
或
|
或
|
||||||
HTTP请求 → 模拟浏览器 → 获取Cookie
|
HTTP请求 → 模拟浏览器 → 获取Cookie
|
||||||
```
|
```
|
||||||
|
|
||||||
2. **视频下载**
|
### 2. 视频下载
|
||||||
```
|
```
|
||||||
解析分享链接 → 调用f2库 → 请求抖音API → 获取视频URL → 下载到本地
|
解析分享链接 → 调用f2库 → 请求抖音API → 获取视频URL → 下载到本地
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### 3. 异步处理
|
||||||
|
```
|
||||||
|
任务队列 → 并发下载 → 自动重试 → 保存文件
|
||||||
|
```
|
||||||
|
|
||||||
## ⚠️ 注意事项
|
## ⚠️ 注意事项
|
||||||
|
|
||||||
- Cookie有效期为几天,过期会自动刷新
|
- Cookie有效期为几天,过期会自动刷新
|
||||||
- 请勿频繁下载,避免触发风控
|
- 请勿频繁下载,避免触发风控
|
||||||
- 仅供学习研究使用,请尊重版权
|
- 仅供学习研究使用,请尊重版权
|
||||||
|
- 建议设置合理的时间间隔和并发数
|
||||||
|
|
||||||
|
## 🔐 隐私安全
|
||||||
|
|
||||||
|
- ✅ **完全本地运行** - 数据不上传
|
||||||
|
- ✅ **开源透明** - 代码可审查
|
||||||
|
- ✅ **无第三方服务** - 直接访问抖音
|
||||||
|
- ✅ **Cookie本地存储** - 隐私保护
|
||||||
|
|
||||||
|
## 📊 性能优化
|
||||||
|
|
||||||
|
### 下载速度
|
||||||
|
- 异步并发下载
|
||||||
|
- 自动断点续传
|
||||||
|
- 智能重试机制
|
||||||
|
|
||||||
|
### 资源占用
|
||||||
|
- 内存优化
|
||||||
|
- 连接池复用
|
||||||
|
- 任务队列管理
|
||||||
|
|
||||||
## 📄 许可证
|
## 📄 许可证
|
||||||
|
|
||||||
@@ -133,7 +282,18 @@ MIT License
|
|||||||
1. Python版本是否正确
|
1. Python版本是否正确
|
||||||
2. 网络是否正常
|
2. 网络是否正常
|
||||||
3. 是否有浏览器(可选)
|
3. 是否有浏览器(可选)
|
||||||
4. 查看日志输出的错误信息
|
4. Cookie是否有效
|
||||||
|
5. 查看日志输出的错误信息
|
||||||
|
|
||||||
|
## 🆕 更新日志
|
||||||
|
|
||||||
|
### v3.0
|
||||||
|
- ✅ 多浏览器支持(Edge/Chrome/Firefox)
|
||||||
|
- ✅ HTTP请求fallback
|
||||||
|
- ✅ GUI界面优化
|
||||||
|
- ✅ 自动Cookie管理
|
||||||
|
- ✅ 9种下载模式
|
||||||
|
- ✅ 丰富的配置选项
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user