docs: Add comprehensive feature list
This commit is contained in:
236
README.md
236
README.md
@@ -1,15 +1,106 @@
|
||||
# 抖音去水印下载器 v3.0
|
||||
|
||||
自动Cookie | 无需登录 | 一键下载 | 支持多环境
|
||||
自动Cookie | 无需登录 | 一键下载 | 支持多环境 | 功能丰富
|
||||
|
||||
## ✨ 特性
|
||||
## ✨ 核心特性
|
||||
|
||||
- ✅ **自动Cookie获取** - 无需手动操作
|
||||
- ✅ **多浏览器支持** - Edge/Chrome/Firefox
|
||||
- ✅ **HTTP请求方式** - 无浏览器也能用
|
||||
- ✅ **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
|
||||
```
|
||||
|
||||
### 方式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+
|
||||
@@ -34,28 +144,29 @@
|
||||
- Mozilla Firefox
|
||||
- **网络** - 能访问 www.douyin.com
|
||||
|
||||
## 🎯 使用方法
|
||||
## 🎯 使用场景
|
||||
|
||||
1. **粘贴链接** - 复制抖音分享链接到输入框
|
||||
2. **点击下载** - 自动获取Cookie并下载
|
||||
3. **完成** - 视频保存在下载目录
|
||||
### 个人使用
|
||||
- 保存喜欢的视频
|
||||
- 备份自己的作品
|
||||
- 收藏音乐和文案
|
||||
|
||||
## 🔄 Cookie自动获取机制
|
||||
### 内容创作
|
||||
- 素材收集
|
||||
- 视频分析
|
||||
- 灵感参考
|
||||
|
||||
程序会自动尝试以下方式获取Cookie：
|
||||
|
||||
1. **Edge浏览器**（优先）
|
||||
2. **Chrome浏览器**（备选）
|
||||
3. **Firefox浏览器**（备选）
|
||||
4. **HTTP请求**（无浏览器时）
|
||||
5. **手动输入**（最后备选）
|
||||
### 数据分析
|
||||
- 批量采集
|
||||
- 数据备份
|
||||
- 趋势研究
|
||||
|
||||
## 📦 依赖安装
|
||||
|
||||
首次运行会自动安装：
|
||||
|
||||
```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）
|
||||
|
||||
## 🎨 功能说明
|
||||
## 🎨 使用技巧
|
||||
|
||||
### 下载模式
|
||||
### 1. 批量下载
|
||||
```
|
||||
模式：用户主页
|
||||
链接：用户主页分享链接
|
||||
数量：0（全部）
|
||||
```
|
||||
|
||||
- **单个作品** - 下载单个视频
|
||||
- **用户主页** - 批量下载用户发布作品
|
||||
- **用户喜欢** - 下载用户点赞作品
|
||||
- **用户收藏** - 下载用户收藏作品
|
||||
- **直播** - 录制直播间
|
||||
### 2. 定期备份
|
||||
```
|
||||
模式：用户主页
|
||||
链接：自己的主页
|
||||
时间：2024-01-01|2024-12-31
|
||||
```
|
||||
|
||||
### 高级选项
|
||||
### 3. 音乐收藏
|
||||
```
|
||||
模式：收藏音乐
|
||||
选项：下载原声 ✓
|
||||
```
|
||||
|
||||
- **下载原声** - 保存视频背景音乐
|
||||
- **下载封面** - 保存视频封面图片
|
||||
- **作品数量** - 限制下载数量（0=全部）
|
||||
### 4. 代理加速
|
||||
```
|
||||
设置：HTTP代理
|
||||
地址：http://127.0.0.1:7890
|
||||
```
|
||||
|
||||
## 🔧 技术栈
|
||||
|
||||
@@ -97,26 +220,52 @@ pip install selenium webdriver-manager requests
|
||||
- **f2** - 抖音API库
|
||||
- **tkinter** - GUI界面
|
||||
- **requests** - HTTP请求
|
||||
- **asyncio** - 异步下载
|
||||
|
||||
## 📝 工作原理
|
||||
|
||||
1. **自动Cookie**
|
||||
```
|
||||
Selenium启动浏览器 → 访问抖音 → 提取Cookie
|
||||
或
|
||||
HTTP请求 → 模拟浏览器 → 获取Cookie
|
||||
```
|
||||
### 1. Cookie获取
|
||||
```
|
||||
Selenium启动浏览器 → 访问抖音 → 提取Cookie
|
||||
或
|
||||
HTTP请求 → 模拟浏览器 → 获取Cookie
|
||||
```
|
||||
|
||||
2. **视频下载**
|
||||
```
|
||||
解析分享链接 → 调用f2库 → 请求抖音API → 获取视频URL → 下载到本地
|
||||
```
|
||||
### 2. 视频下载
|
||||
```
|
||||
解析分享链接 → 调用f2库 → 请求抖音API → 获取视频URL → 下载到本地
|
||||
```
|
||||
|
||||
### 3. 异步处理
|
||||
```
|
||||
任务队列 → 并发下载 → 自动重试 → 保存文件
|
||||
```
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
- Cookie有效期为几天，过期会自动刷新
|
||||
- 请勿频繁下载，避免触发风控
|
||||
- 仅供学习研究使用，请尊重版权
|
||||
- 建议设置合理的时间间隔和并发数
|
||||
|
||||
## 🔐 隐私安全
|
||||
|
||||
- ✅ **完全本地运行** - 数据不上传
|
||||
- ✅ **开源透明** - 代码可审查
|
||||
- ✅ **无第三方服务** - 直接访问抖音
|
||||
- ✅ **Cookie本地存储** - 隐私保护
|
||||
|
||||
## 📊 性能优化
|
||||
|
||||
### 下载速度
|
||||
- 异步并发下载
|
||||
- 自动断点续传
|
||||
- 智能重试机制
|
||||
|
||||
### 资源占用
|
||||
- 内存优化
|
||||
- 连接池复用
|
||||
- 任务队列管理
|
||||
|
||||
## 📄 许可证
|
||||
|
||||
@@ -133,7 +282,18 @@ MIT License
|
||||
1. Python版本是否正确
|
||||
2. 网络是否正常
|
||||
3. 是否有浏览器（可选）
|
||||
4. 查看日志输出的错误信息
|
||||
4. Cookie是否有效
|
||||
5. 查看日志输出的错误信息
|
||||
|
||||
## 🆕 更新日志
|
||||
|
||||
### v3.0
|
||||
- ✅ 多浏览器支持（Edge/Chrome/Firefox）
|
||||
- ✅ HTTP请求fallback
|
||||
- ✅ GUI界面优化
|
||||
- ✅ 自动Cookie管理
|
||||
- ✅ 9种下载模式
|
||||
- ✅ 丰富的配置选项
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user