- 直播间监控 - 添加抖音直播间链接,实时查看主播开播状态
- 一键录制 - 开播后点击录制,自动下载直播流
- 多画质支持 - 蓝光 / 高清 / 标清 / 流畅,自由选择
- FLV 转 MP4 - 录制完成后一键转换,支持自动转换
- 代理支持 - 可配置 HTTP 代理,适应不同网络环境
- 本地存储 - 数据保存在本地 SQLite 数据库,隐私安全
- 轻量桌面应用 - 基于 Tauri,体积小、启动快、资源占用低
🚀快速开始
前往 Releases 页面,下载最新版本的安装包:
| 系统 | 下载文件 |
|---|---|
| Windows | douyin-recorder_x.x.x_x64-setup.exe |
- Windows:双击
.exe安装包,按提示完成安装
- 打开应用,在顶部输入框粘贴抖音直播间链接(格式:
https://live.douyin.com/房间号) - 点击"添加"按钮,房间会出现在监控列表中
- 等待主播开播(状态显示为绿色"直播中"),点击"录制"按钮
- 录制完成后,在任务列表点击"转换为 MP4"即可
录制文件默认保存在 DouyinRecordings 文件夹(可在设置中修改)。
提示:如果网络正常访问抖音,无需额外配置代理。如果添加直播间失败,请确认使用的是完整的
https://live.douyin.com/房间号格式链接。
点击右上角齿轮图标打开设置面板:
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 代理地址 | HTTP 代理 (如 http://127.0.0.1:7890) |
空 |
| Cookie | 浏览器 Cookie,用于绕过反爬 | 空 |
| 画质偏好 | 蓝光 / 高清 / 标清 / 流畅 | 高清 |
| 录制目录 | 录制文件保存位置 | ~/DouyinRecordings |
| 数据库路径 | SQLite 数据库文件位置 | ~/.douyin-recorder/ |
| 自动转 MP4 | 录制停止后自动转换格式 | 关闭 |
| 24 小时制 | 时间显示格式 | 开启 |
Q: 为什么添加直播间失败?
A: 请确认使用的是 https://live.douyin.com/房间号 格式的完整链接,短链接暂不支持。
Q: 录制的文件在哪里?
A: 默认保存在用户目录下的 DouyinRecordings 文件夹,可在设置中修改。
Q: 需要配置代理吗? A: 如果你的网络环境可以正常访问抖音,则不需要配置代理。
Q: 支持哪些画质? A: 支持蓝光 (FULL_HD1)、高清 (HD1)、标清 (SD1)、流畅 (SD2),会根据主播推流自动匹配。
本项目使用了 FFmpeg 作为录制引擎,详见 第三方许可证声明。
如果你在使用过程中遇到任何问题,或者有好的建议,欢迎:
- 提交 Issue
- 提交 Pull Request 参与开发
- 给项目点个 Star ⭐ 支持一下
以下内容面向开发者,普通用户无需关注。
| 层级 | 技术 |
|---|---|
| 前端 | Vue 3 + TypeScript + Element Plus + Pinia |
| 后端 | Rust + Tauri 2 |
| 数据库 | SQLite (rusqlite) |
| 录制引擎 | FFmpeg (sidecar) |
| 构建工具 | Vite 6 + pnpm |
本项目使用 FFmpeg 作为录制引擎,以 sidecar 方式打包。由于 FFmpeg 二进制文件较大(约 200MB),不包含在 git 仓库中,需要手动下载并放置。
下载 FFmpeg:
- 访问 FFmpeg 官方下载页面:https://ffmpeg.org/download.html
- 选择适合你操作系统的版本:
- Windows:下载 Windows 版本(推荐使用 gyan.dev 的构建版本)
- macOS:使用 Homebrew 安装 (
brew install ffmpeg) 或下载静态构建版本 - Linux:使用包管理器安装或下载静态构建版本
放置 FFmpeg:
将下载的 FFmpeg 可执行文件放置到以下目录:
src-tauri/binaries/
文件命名规则:
FFmpeg 二进制文件需要按照 Tauri sidecar 的命名规则放置:
| 操作系统 | 目标平台 | 文件名 |
|---|---|---|
| Windows | x86_64 | ffmpeg-x86_64-pc-windows-msvc.exe |
| Windows | x86 (32位) | ffmpeg-i686-pc-windows-msvc.exe |
| macOS | Intel | ffmpeg-x86_64-apple-darwin |
| macOS | Apple Silicon | ffmpeg-aarch64-apple-darwin |
| Linux | x86_64 | ffmpeg-x86_64-unknown-linux-gnu |
| Linux | ARM64 | ffmpeg-aarch64-unknown-linux-gnu |
示例(Windows):
# 创建 binaries 目录(如果不存在)
mkdir -p src-tauri/binaries
# 将下载的 ffmpeg.exe 重命名并移动到正确位置
mv ffmpeg.exe src-tauri/binaries/ffmpeg-x86_64-pc-windows-msvc.exe验证配置:
# 测试 FFmpeg 是否可用
./src-tauri/binaries/ffmpeg-x86_64-pc-windows-msvc.exe -version注意:如果你只需要在当前平台开发和构建,只需下载对应平台的 FFmpeg 版本即可。如果需要跨平台构建,需要下载所有目标平台的版本。
# 1. 克隆项目
git clone https://github.com/SplashedWhite/douyin-recorder.git
cd douyin-recorder
# 2. 安装依赖
pnpm install
# 3. 启动开发模式
pnpm tauri devpnpm tauri build构建完成后,安装包将输出到 src-tauri/target/release/bundle/ 目录。
douyin-recorder/
├── src/ # 前端源码
│ ├── components/ # Vue 组件
│ │ ├── RoomList.vue # 直播间列表
│ │ ├── TaskList.vue # 录制任务列表
│ │ └── Settings.vue # 设置面板
│ ├── stores/ # Pinia 状态管理
│ └── types/ # TypeScript 类型定义
├── src-tauri/ # 后端源码
│ ├── src/
│ │ ├── lib.rs # 核心逻辑 & Tauri 命令
│ │ ├── parser.rs # 抖音 API 解析
│ │ ├── recorder.rs # FFmpeg 录制管理
│ │ ├── database.rs # SQLite 数据库层
│ │ └── settings.rs # 配置管理
│ ├── binaries/ # FFmpeg sidecar 二进制(需手动下载)
│ └── tauri.conf.json # Tauri 配置
├── package.json
└── vite.config.ts

