Douyin Capture

Douyin Capture

Import Douyin share links or pasted share text into your vault. Download no-watermark videos, post images, and captions, then create structured notes with titles, topics, tags, and frontmatter. Video posts can be transcribed to Simplified Chinese with a local Whisper backend. All media stays on your machine.

Required: This plugin needs the local Python service obsidian-content-capture-backend. Install and run it before using the plugin. Nothing is sent to a cloud service.

Desktop only (Obsidian 1.4.0+). Default backend URL: http://127.0.0.1:5050.

Quick start

1. Clone and run the backend (python web/app.py after pip install -r requirements.txt; FFmpeg required for video transcription).
2. Install this plugin from Releases into .obsidian/plugins/douyin-capture/ (main.js, manifest.json, styles.css).
3. Enable Douyin Capture in Settings → Community plugins.

---

中文说明

将抖音分享链接一键导入 Obsidian：在本地提取视频 / 配图 / 文案，自动生成结构化笔记。

重要：本插件依赖本地 Python 后端 obsidian-content-capture-backend，不会在云端处理你的链接或媒体。请先安装并启动后端，再使用插件。

功能亮点

支持的链接形式：v.douyin.com 短链、www.douyin.com/note|video、iesdouyin.com/share/...，或直接粘贴整段分享文案。

环境要求

默认后端地址：http://127.0.0.1:5050

快速开始

1. 启动本地后端

git clone https://github.com/lyxdream/obsidian-content-capture-backend.git
cd obsidian-content-capture-backend

python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# macOS 视频转写需要
brew install ffmpeg

python web/app.py
# 浏览器可打开 http://127.0.0.1:5050 做联调

终端保持运行；关闭后插件将无法提取。

2. 安装本插件

方式 A：从 Release 安装

1. 打开 Releases，下载对应版本的压缩包（需包含 main.js、manifest.json、styles.css）。

2. 解压到库目录：

   <你的 Vault>/.obsidian/plugins/douyin-capture/
   ├── main.js
   ├── manifest.json
   ├── styles.css
   └── versions.json   # 若有
   

3. Obsidian → 设置 → 第三方插件 → 关闭安全模式 → 启用「Douyin Capture」。

方式 C：社区插件市场（推荐给普通用户）

设置 → 第三方插件 → 浏览 → 搜索 Douyin Capture → 安装 → 启用。

方式 B：手动构建

git clone https://github.com/lyxdream/obsidian-douyin-capture.git
cd obsidian-douyin-capture
npm install
npm run build

将整个插件目录（含生成的 main.js）放入 .obsidian/plugins/douyin-capture/，或在开发时用符号链接指向该目录。

3. 配置插件

设置 → Douyin Capture：

页面顶部会显示后端连接状态（● 已连接 / ● 未连接）。

使用说明

侧边栏

点击左侧 Ribbon 的摄像机图标，打开 import douyin 弹窗。

弹窗操作

1. 粘贴抖音分享链接或整段分享文案
2. 选择：
   • 提取文案：完整流程（视频含 Whisper 转写，图文含配图与配文）
   • 提取视频：仅下载无水印视频并写入笔记，不进行转写（适合先存视频、稍后再转写）
   • 取消：关闭弹窗

提取过程中会显示步骤进度（检查服务 → 解析/下载 → 写入 Vault）。

命令面板

生成的笔记示例

• 路径：Douyin/2026-06-04-作者-标题摘要.md
• 正文：一级标题 + 话题标签引用块 + 视频/配图 + ## 文案
• Frontmatter：type、content_type、douyin_id、author、source、tags 等

详细字段与失败降级模板见 docs/obsidian-plugin-contract.md。

架构说明

┌─────────────────┐     HTTP (localhost)     ┌──────────────────────────────┐
│  Obsidian       │  POST /api/video/extract │  obsidian-content-capture-   │
│  Douyin Capture │ ───────────────────────► │  backend (Python + Flask)    │
│  插件           │ ◄─────────────────────── │  解析 / 下载 / Whisper       │
└────────┬────────┘                          └──────────────────────────────┘
         │ 拷贝 media + 写 .md
         ▼
┌─────────────────┐
│  Vault          │
│  Douyin/*.md    │
│  attachments/…  │
└─────────────────┘

插件只负责调用 API、把 output/ 中的媒体复制进 Vault、渲染 Markdown；核心能力由后端提供。

常见问题

开发

npm install
npm run dev      # 监听编译
npm run build    # 生产构建 → main.js

后端开发见 obsidian-content-capture-backend。

发布检查清单

向 Obsidian 社区插件目录 提交前建议确认：

• manifest.json：id = douyin-capture，version 与 Release tag 一致，minAppVersion 正确
• versions.json 含对应版本键（如 "1.0.1": "1.4.0"），与 manifest 一致
• 已执行 npm run build，Release 附件包含 main.js（仓库 .gitignore 忽略 main.js，发布时需单独打包）
• README 中说明必须安装本地后端（社区审核关注点）
• LICENSE 与仓库一致（MIT）
• 在全新 Vault 中手动安装测试一遍完整流程

相关仓库

许可与声明

本项目采用 MIT 许可。

抖音内容与平台规则归原平台所有。请仅将本工具用于个人学习与研究，勿用于侵权或违反平台条款的用途。作者不对使用本工具产生的后果承担责任。