Douyin Capture Pro

Douyin Capture Pro

Fork 声明：本项目基于 lyxdream/obsidian-douyin-capture 修改，原代码地址：https://github.com/lyxdream/obsidian-douyin-capture

Language / 语言: English · 中文

---

Fork Note: This project is forked from lyxdream/obsidian-douyin-capture. Original repository: https://github.com/lyxdream/obsidian-douyin-capture

Import Douyin (TikTok China) share links or pasted share text into your Obsidian vault. Download no-watermark videos, carousel images, and captions, then create structured notes with titles, hashtags, 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 depends on the local Python service obsidian-content-capture-backend. Install and run it before using the plugin. Nothing is sent to a cloud service.

Features

Supported link formats: v.douyin.com short links, www.douyin.com/note|video, iesdouyin.com/share/..., or pasted share text containing a link.

Requirements

Default backend URL: http://127.0.0.1:5050

Quick start

1. Start the local backend

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 — video transcription
brew install ffmpeg

python web/app.py
# Optional: open http://127.0.0.1:5050 in a browser for testing

Keep the terminal running. The plugin cannot extract content after the backend stops.

2. Install this plugin

From Releases (recommended)

1. Open Releases and download the build for your version (main.js, manifest.json, styles.css).

2. Extract into your vault:

   <Your Vault>/.obsidian/plugins/douyin-capture/
   ├── main.js
   ├── manifest.json
   ├── styles.css
   └── versions.json   # if included
   

3. Obsidian → Settings → Community plugins → turn off Restricted mode → enable Douyin Capture.

From the community catalog

Settings → Community plugins → Browse → search Douyin Capture → Install → Enable.

Build from source

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

Copy the plugin folder (including generated main.js) into .obsidian/plugins/douyin-capture/, or symlink it during development.

3. Configure the plugin

Settings → Douyin Capture

The settings page shows backend status (connected / disconnected).

Usage

Ribbon icon — Click the camera icon in the left ribbon to open the import douyin modal.

Modal actions

1. Paste a Douyin share link or full share text.
2. Choose:
   • Extract caption — full pipeline (Whisper for videos; images + caption for image posts)
   • Extract video — download no-watermark video only, no transcription
   • Cancel — close the modal

Progress steps are shown during extraction (health check → parse/download → write to vault).

Command palette

Generated notes

• Path: Douyin/2026-06-04-author-title-slug.md
• Body: level-1 title, hashtag callout, video/images, ## Caption
• Frontmatter: type, content_type, douyin_id, author, source, tags, etc.

See docs/obsidian-plugin-contract.md for field details and fallback templates.

Architecture

┌─────────────────┐     HTTP (localhost)     ┌──────────────────────────────┐
│  Obsidian       │  POST /api/video/extract │  obsidian-content-capture-   │
│  Douyin Capture │ ───────────────────────► │  backend (Python + Flask)    │
│  plugin         │ ◄─────────────────────── │  parse / download / Whisper  │
└────────┬────────┘                          └──────────────────────────────┘
         │ copy media + write .md
         ▼
┌─────────────────┐
│  Vault          │
│  Douyin/*.md    │
│  attachments/…  │
└─────────────────┘

The plugin calls the API, copies media from output/ into the vault, and renders Markdown. Core extraction runs in the backend.

FAQ

Development

npm install
npm run dev      # watch build
npm run build    # production → main.js

Backend development: obsidian-content-capture-backend.

License and disclaimer

This project is licensed under MIT.

Douyin content and platform rules belong to the platform. Use this tool for personal learning and research only. Do not use it for copyright infringement or terms-of-service violations. The author is not responsible for consequences of using this tool.

---

Fork 声明：本项目基于 lyxdream/obsidian-douyin-capture 修改，原代码地址：https://github.com/lyxdream/obsidian-douyin-capture

将抖音分享链接一键导入 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」。

方式 B：社区插件市场

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

方式 C：手动构建

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 含对应版本键，与 manifest 一致
• 已执行 npm run build，Release 附件包含 main.js
• README 含英文说明，并注明必须安装本地后端
• LICENSE 与仓库一致（MIT）
• 在全新 Vault 中手动安装测试一遍完整流程

许可与声明

本项目采用 MIT 许可。

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