douyin-to-obsidian skill
A skill that turns Douyin videos and photo posts into topic notes in Obsidian with local transcription and an index.
- 206 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Scripts reach Douyin using your Chrome profile and write into the Obsidian vault.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/douyin-to-obsidianDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Scripts reach Douyin using your Chrome profile and write into the Obsidian vault.
This is third-party code. Review the repository files before installing.
What it does
The `/dy` command turns specified Douyin videos and photo posts into topic-organized Obsidian notes. Video is transcribed locally with MLX Whisper, text from images is recognized by Apple Vision, and an agent with vision checks pages against the original. A note contains an explanation, evidence, model additions and self-test questions. Project scripts fetch material, deduplicate by work ID, validate and save data transactionally: the note, attachments, knowledge index and import log reach the vault together. If the text mentions an interview, interview questions are generated too. The installer adds a command, a skill and a routing hook to the Claude Code workspace; CC Connect integration is optional.
Who it is for. Mac users with Obsidian who save knowledge from Douyin and want an agent to turn it into connected notes.
Good fit when
- A set of Douyin lectures should land in an Obsidian vault by topic.
- A photo post with text on images must be recognized and checked against the original.
- The same video arrived again and the duplicate must be detected by work ID.
- Only new works from a specified favorites folder need importing.
Not a fit when
- The computer is not Apple Silicon, and the full flow for Intel Mac, Windows and Linux is not guaranteed.
- There is no Chrome profile signed in to Douyin for private favorites.
- You want bulk download of all works by an author through the plain `/dy`, which has a separate `/dy-author`.
Example request
/dy save this Douyin video into my Obsidian vault and put the key ideas in a topic note.Limitations
The full flow targets macOS on Apple Silicon, Python 3.12, Node.js for F2 signing, Chrome with your profile and Xcode Command Line Tools for recognition. Private favorites require a Douyin login in that profile; the installer creates no profiles, copies no cookies and asks for no export. The agent must read skills, write files, run scripts and view images. Documentation is in Chinese. The license is MIT. The last commit is dated November 2026.
How to disable. Delete `.claude/skills/douyin-to-obsidian`, `commands/dy.md` and the hook entry in `settings.json` from the workspace. Notes in Obsidian remain.
FAQ
How do I install the skill?
Clone the repository and run `scripts/install.py` with absolute `--workspace`, `--vault` and `--browser-profile` paths using a Python 3.12 interpreter.
What does the installer create?
Under `workspace/.claude/` it adds the skill with its own virtual environment, the `dy.md` command and a merged `settings.json` with an auto-routing hook.
Is CC Connect required?
No. The core flow does not depend on CC Connect or a WeChat bot. The integration sits in `integrations/cc-connect`.
How does the skill avoid duplicates?
By the Douyin work ID. It finds already saved notes even if renamed or moved and keeps your additions.
What happens when a batch fails?
A work already saved is not rolled back. The skill tracks batch progress, gaps and a limited number of retries and gives links for another attempt.
Discussion
No questions or reviews yet.
Related
SkillsSkill that syncs favorite Douyin videos into a local Markdown or Obsidian base with speech transcripts and a daily digest.
Obsidian skills
Obsidian Skills
Skills for agents working with Obsidian: Markdown with wikilinks, Bases, JSON Canvas, Obsidian CLI, Defuddle and Knap
A CLI and Codex skill turning YouTube and Bilibili videos into transcripts and timestamped summaries, with Notion export.
Eight Claude Code skills for Obsidian: Granola notes, NotebookLM imports, TaskNotes tasks, recall of past sessions, chat export
Skill linking an agent to the 得到大脑 notes service: saves links and images, searches by meaning, files notes in knowledge bases.
A skill that turns PDFs, docs and a codebase into an Obsidian study vault: structured notes for self-study
README in short
The README lists features, system requirements, installation and the `/dy` and `/dy-author` routes. It describes transactions, retries and recommendations for note structure.