# better-douyin — 抖音内容下载、预览与本地归档桌面工具

> 免费开源的抖音下载工具，搜索用户或粘贴分享链接就能批量下载视频、图集和原声，支持Windows/Mac/Linux桌面运行和浏览器无界面部署

## 功能亮点

- **搜索抖音用户** — 查看主页作品、收藏、点赞等内容
- **粘贴分享链接** — 解析单条作品，支持视频、图集和 Live Photo
- **批量下载** — 用户作品、搜索结果、推荐流、收藏列表、点赞列表一键下载，按用户/合集归档
- **推荐流预览** — 沉浸式播放器，左右切换、进度控制、音量控制、自动播放下一条
- **原声/BGM下载** — 支持单独下载视频原声
- **桌面+浏览器双模式** — 支持桌面窗口运行，也支持浏览器/无界面模式部署到服务器
- **本地隐私** — Cookie、配置、下载历史和本地文件全部保存在本机

## 技术栈

| 模块 | 技术 |
|------|------|
| 桌面窗口 | pywebview |
| 本地服务 | Flask, Flask-SocketIO |
| 下载引擎 | asyncio, aiohttp, requests |
| 前端界面 | React, Vite, TypeScript, Tailwind CSS |
| 打包分发 | PyInstaller |

## 支持平台

- Windows（安装版 + 便携版）
- macOS（Apple Silicon / Intel）
- Linux（deb / rpm / tar.gz 通用便携）

## 开发运行

```bash
git clone https://github.com/anYuJia/better-douyin.git
cd better-douyin
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
npm --prefix frontend install
npm --prefix frontend run build
python main.py
```

浏览器/无界面模式：`python -m src.web.web_app`

> ⚠️ **注意**：本项目采用 PolyForm Noncommercial 1.0.0 许可，仅限个人非商业学习研究使用，禁止商业分发和收费代下。

---

**分类**：软件
**标签**：下载 · 桌面 · 本地
**作者**：Xiao.Xi
**链接**：https://octohz.com/p/1887