tiktok/README.md

# 抖音去水印下载器 v3.0

自动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方式
- **自动保存** - 本地文件存储
- **自动刷新** - 过期自动更新
- **手动输入** - 支持手动配置

## 🚀 快速开始

### 方式1：双击启动（推荐）

```
双击 启动UI.vbs
```

### 方式2：命令行启动

```bash
"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+
- **浏览器**（可选）：
  - Microsoft Edge
  - Google Chrome
  - Mozilla Firefox
- **网络** - 能访问 www.douyin.com

## 🎯 使用场景

### 个人使用
- 保存喜欢的视频
- 备份自己的作品
- 收藏音乐和文案

### 内容创作
- 素材收集
- 视频分析
- 灵感参考

### 数据分析
- 批量采集
- 数据备份
- 趋势研究

## 📦 依赖安装

首次运行会自动安装：

```bash
pip install selenium webdriver-manager requests f2
```

## 🌍 环境兼容性

### 有浏览器环境
- ✅ Windows 10/11 + Edge
- ✅ Windows + Chrome
- ✅ Windows + Firefox
- ✅ macOS + Chrome/Firefox
- ✅ Linux + Chrome/Firefox

### 无浏览器环境
- ✅ 服务器环境
- ✅ Docker容器
- ✅ CI/CD环境

（使用HTTP请求方式获取Cookie）

## 🎨 使用技巧

### 1. 批量下载
```
模式：用户主页
链接：用户主页分享链接
数量：0（全部）
```

### 2. 定期备份
```
模式：用户主页
链接：自己的主页
时间：2024-01-01|2024-12-31
```

### 3. 音乐收藏
```
模式：收藏音乐
选项：下载原声 ✓
```

### 4. 代理加速
```
设置：HTTP代理
地址：http://127.0.0.1:7890
```

## 🔧 技术栈

- **Python 3.11** - 核心语言
- **Selenium** - 浏览器自动化
- **f2** - 抖音API库
- **tkinter** - GUI界面
- **requests** - HTTP请求
- **asyncio** - 异步下载

## 📝 工作原理

### 1. Cookie获取
```
Selenium启动浏览器 → 访问抖音 → 提取Cookie
或
HTTP请求 → 模拟浏览器 → 获取Cookie
```

### 2. 视频下载
```
解析分享链接 → 调用f2库 → 请求抖音API → 获取视频URL → 下载到本地
```

### 3. 异步处理
```
任务队列 → 并发下载 → 自动重试 → 保存文件
```

## ⚠️ 注意事项

- Cookie有效期为几天，过期会自动刷新
- 请勿频繁下载，避免触发风控
- 仅供学习研究使用，请尊重版权
- 建议设置合理的时间间隔和并发数

## 🔐 隐私安全

- ✅ **完全本地运行** - 数据不上传
- ✅ **开源透明** - 代码可审查
- ✅ **无第三方服务** - 直接访问抖音
- ✅ **Cookie本地存储** - 隐私保护

## 📊 性能优化

### 下载速度
- 异步并发下载
- 自动断点续传
- 智能重试机制

### 资源占用
- 内存优化
- 连接池复用
- 任务队列管理

## 📄 许可证

MIT License

## 🙏 致谢

- [f2](https://github.com/Johnserf-Seed/f2) - 抖音API库
- [TikTokDownload](https://github.com/Johnserf-Seed/TikTokDownload) - 原项目

## 🐛 问题反馈

如遇问题，请检查：
1. Python版本是否正确
2. 网络是否正常
3. 是否有浏览器（可选）
4. Cookie是否有效
5. 查看日志输出的错误信息

## 🆕 更新日志

### v3.0
- ✅ 多浏览器支持（Edge/Chrome/Firefox）
- ✅ HTTP请求fallback
- ✅ GUI界面优化
- ✅ 自动Cookie管理
- ✅ 9种下载模式
- ✅ 丰富的配置选项

---

**Made with ❤️ for Douyin users**