Back to search
claude-skill-video-transcribe
SkillWorks with Claude CodeGitHub
视频转文字工具:有字幕抓字幕,没字幕 AI 听写。支持 YouTube/B站/本地文件,Gemini 2.5 Flash 转录引擎
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/jane-xiaoer--claude-skill-video-transcribe)HTML
<a href="/listings/jane-xiaoer--claude-skill-video-transcribe"><img src="/api/listings/jane-xiaoer--claude-skill-video-transcribe/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 36 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: VideoTranscribe
- description: 视频/音频转文字 + 核心提炼。USE WHEN 用户提到:转录、转文字、字幕、视频转文字、音频转文字、抓字幕、YouTube转文字、B站转文字、视频笔记、transcript、提炼视频重点、视频总结。
- ---
- # VideoTranscribe
- 将视频/音频内容转成文字,并可进一步提炼核心要点。
- 支持:
- - **本地文件**:MP4、MOV、MP3、M4A 等
- - **在线 URL**:YouTube、B站、小宇宙、优酷等 yt-dlp 支持的平台
- - **提炼模式**:转录完成后可输出结构化要点摘要
- ## 🔊 Voice Notification(必须先执行)
- ```bash
- curl -s -X POST http://localhost:8888/notify \
- -H "Content-Type: application/json" \
- -d '{"message": "Running VideoTranscribe skill"}' > /dev/null 2>&1 &
- ```
- ## Workflow Routing
- | 用户说的 | 路由到 |
- |---------|--------|
- | 转录 / 转文字 / 字幕 / 发来视频文件或URL | `Workflows/Transcribe.md` |
- | 提炼 / 总结 / 核心要点 / 重点 | `Workflows/Extract.md` |
- | 两者都要(先转再提炼)| 先 `Transcribe.md`,再 `Extract.md` |
- ## Quick Reference
- - 脚本路径:`~/.shared-skills/VideoTranscribe/Tools/transcribe.py`
- - 优先策略:URL → 抓字幕(快)→ 无字幕则下音频转录
- - 转录引擎:Gemini 2.5 Flash(有标点) / mlx-whisper(离线备选)
- - 输出默认存:`~/Downloads/transcript_YYYYMMDD_HHMMSS.txt`
README.md · README · 126 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 视频转文字工具(VideoTranscribe)
- > AI 驱动的视频/音频转录工具。有字幕抓字幕,没字幕用 AI 听写——YouTube、B站、本地文件全支持。
- ## 功能
- - **本地文件转录**:MP4、MOV、MP3、M4A 等,ffmpeg 自动提音频
- - **URL 转录**:YouTube、B站、小宇宙,任何 yt-dlp 支持的平台
- - **字幕优先策略**:有字幕直接抓(快速、0 API 消耗),没有才下音频转录
- - **两种引擎**:Gemini 2.5 Flash(有标点、推荐)/ mlx-whisper(本地离线)
- - **内容提炼**:三种模式——快速摘要 / 结构化笔记 / 内容再创作
- ## 快速开始
- ```bash
- # 转录本地视频
- python3 Tools/transcribe.py --input "video.mp4"
- # 转录 YouTube 视频
- python3 Tools/transcribe.py --input "https://youtu.be/xxx"
- # 转录 B站视频
- python3 Tools/transcribe.py --input "https://www.bilibili.com/video/BVxxx"
- # 使用本地 mlx-whisper(离线)
- python3 Tools/transcribe.py --input "video.mp4" --engine mlx
- # 指定输出路径
- python3 Tools/transcribe.py --input "video.mp4" --output ~/Desktop/result.txt
- ```
- ## 依赖安装
- ```bash
- # 必需
- pip3 install google-genai # Gemini 引擎(推荐)
- brew install yt-dlp ffmpeg # 音频处理
- # 可选(本地离线引擎)
- pip3 install mlx-whisper # 仅 Apple Silicon
- ```
- ## API Key 配置
- Gemini 引擎需要 API Key,从 [Google AI Studio](https://aistudio.google.com/) 免费申请:
- ```bash
- # 方式一:环境变量
- export GEMINI_API_KEY="your-key"
- # 方式二:写入文件(PAI 用户推荐)
- echo 'GEMINI_API_KEY=your-key' >> ~/.shared-skills/api-registry/.env
- ```
- ## 引擎对比
- | 引擎 | 命令 | 优点 | 缺点 |
- |------|------|------|------|
- | `gemini`(默认)| `--engine gemini` | 有标点、可读性好、速度快 | 需网络 + API Key |
- | `mlx` | `--engine mlx` | 完全离线、免费 | 无标点、仅 Apple Silicon |
- ## 接入各类 AI Agent
- ### 直接调用(所有平台通用)
- 任何 AI Agent 只需运行 `run.sh` 或直接调 Python 脚本:
- ```bash
- # 通用入口(推荐)
- bash /path/to/VideoTranscribe/run.sh --input "video.mp4"
- # 或直接调脚本
- python3 /path/to/VideoTranscribe/Tools/transcribe.py --input "video.mp4"
- ```
- ### Claude Code
- 将此目录放入 `~/.shared-skills/`,直接用自然语言触发:
- > "帮我把这个视频转成文字"
- > "把这个 YouTube 链接的内容转录出来"
- ### OpenClaw / Codex / Gemini CLI
- 在 agent 的工具调用或 bash 执行里直接写:
- ```bash
- bash ~/.shared-skills/VideoTranscribe/run.sh --input "{{ input_url_or_path }}"
- ```
- 脚本会自动加载 Gemini API Key 并返回转录结果。
- ## 文件结构
- ```
- VideoTranscribe/
- ├── SKILL.md # Claude Code skill 入口
- ├── Workflows/
- │ ├── Transcribe.md # 转录流程
- │ └── Extract.md # 提炼流程(3种模式)
- └── Tools/
- └── transcribe.py # 核心脚本
- ```
- ## License
- MIT
- ---
- ## 📱 关注作者 / Follow Me
- 如果这个仓库对你有帮助,欢迎关注我。后面我会持续更新更多 AI Skill、视频转字、字幕生成和内容处理工作流。
- If this repo helped you, follow me for more AI skills, video transcription, subtitle generation, and content workflows.
- - X (Twitter): [@xiaoerzhan](https://x.com/xiaoerzhan)
- - 微信公众号 / WeChat Official Account: 扫码关注 / Scan to follow
- <p align="center">
- <img src="./follow-wechat-qrcode.jpg" alt="Jane WeChat Official Account QR code" width="300" />
- </p>
- <p align="center"><strong>中文:</strong>欢迎关注我的公众号,一起研究 AI Skill、视频转字、字幕生成和内容工作流。</p>
- <p align="center"><strong>English:</strong> Follow my WeChat Official Account for more AI skills, video transcription, subtitle generation, and content workflows.</p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.