universal-video-notes

Convert videos from YouTube, Bilibili, and 1700+ sites into structured Obsidian Markdown notes.

19|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/hetiankong/universal-video-notes --skill universal-video-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: universal-video-notes
Source: https://github.com/hetiankong/universal-video-notes/tree/main
Command: npx skills add https://github.com/hetiankong/universal-video-notes --skill universal-video-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill converts videos from Bilibili, YouTube and 1700+ sites into structured Obsidian Markdown documents. It extracts metadata, downloads CC subtitles or performs local ASR transcription, and generates AI-powered notes with YAML frontmatter.

Core Features & Use Cases

  • Video-to-notes workflow: extracts metadata, downloads subtitles or transcribes locally, and outputs Obsidian-ready Markdown with YAML frontmatter.
  • Automated previews: automatically generates a high-quality image preview for notes.
  • Flexible delivery: supports optional Feishu Wiki uploads and REST API-based syncing to Obsidian vaults.
  • Batch-friendly pipeline: designed for single-video and batch processing with an end-to-end workflow.

Quick Start

Install dependencies with python setup.py, configure DEEPSEEK_API_KEY and OBSIDIAN_OUTPUT_DIR in .env, then run the CLI to process a video.

Frequently Asked Questions about universal-video-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert YouTube and Bilibili videos into Obsidian Markdown notes?

You can convert YouTube and Bilibili videos into Obsidian Markdown notes by providing the video URL; the Skill extracts metadata, acquires subtitles or uses local ASR, and outputs structured Markdown files with YAML frontmatter directly into your vault.

Does converting videos to Obsidian notes require local ASR models?

Yes, local ASR models like SenseVoice are required for converting videos to Obsidian notes when closed captions are unavailable, ensuring accurate transcription generation directly on your machine without relying on external cloud APIs.

Can I batch process multiple videos to generate Obsidian Markdown files?

Yes, you can batch process multiple videos to generate Obsidian Markdown files because the workflow is designed for batch-friendly pipeline execution, enabling automated end-to-end metadata extraction and note generation for numerous video URLs simultaneously.

What dependencies do I need to configure for video transcription to Obsidian?

To setup video transcription to Obsidian, you need to install yt-dlp for video access, configure DEEPSEEK_API_KEY for AI-generated YAML frontmatter, and set OBSIDIAN_OUTPUT_DIR in your environment to define the local Obsidian vault output directory.

How do I upload generated Obsidian video notes to Feishu Wiki?

To upload generated Obsidian video notes to Feishu Wiki, the Skill supports optional Feishu Wiki uploads as a flexible delivery mechanism, automatically syncing the structured Markdown output and image previews for team distribution.

Why does my video to Obsidian note conversion fail to get subtitles?

Video to Obsidian note conversion fails to get subtitles when CC subtitles are unavailable on the source platform, triggering the robust error handling pipeline to fallback to local ASR with SenseVoice to transcribe the audio locally.