diff --git a/README.md b/README.md index 10e7864..1c7c21f 100644 --- a/README.md +++ b/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种下载模式 +- ✅ 丰富的配置选项 ---