Skip to content
Back to search

claude-skill-video-transcribe

视频转文字工具:有字幕抓字幕,没字幕 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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jane-xiaoer--claude-skill-video-transcribe/badge.svg)](/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)

  1. ---
  2. name: VideoTranscribe
  3. description: 视频/音频转文字 + 核心提炼。USE WHEN 用户提到:转录、转文字、字幕、视频转文字、音频转文字、抓字幕、YouTube转文字、B站转文字、视频笔记、transcript、提炼视频重点、视频总结。
  4. ---
  5. # VideoTranscribe
  6. 将视频/音频内容转成文字,并可进一步提炼核心要点。
  7. 支持:
  8. - **本地文件**:MP4、MOV、MP3、M4A 等
  9. - **在线 URL**:YouTube、B站、小宇宙、优酷等 yt-dlp 支持的平台
  10. - **提炼模式**:转录完成后可输出结构化要点摘要
  11. ## 🔊 Voice Notification(必须先执行)
  12. ```bash
  13. curl -s -X POST http://localhost:8888/notify \
  14. -H "Content-Type: application/json" \
  15. -d '{"message": "Running VideoTranscribe skill"}' > /dev/null 2>&1 &
  16. ```
  17. ## Workflow Routing
  18. | 用户说的 | 路由到 |
  19. |---------|--------|
  20. | 转录 / 转文字 / 字幕 / 发来视频文件或URL | `Workflows/Transcribe.md` |
  21. | 提炼 / 总结 / 核心要点 / 重点 | `Workflows/Extract.md` |
  22. | 两者都要(先转再提炼)| 先 `Transcribe.md`,再 `Extract.md` |
  23. ## Quick Reference
  24. - 脚本路径:`~/.shared-skills/VideoTranscribe/Tools/transcribe.py`
  25. - 优先策略:URL → 抓字幕(快)→ 无字幕则下音频转录
  26. - 转录引擎:Gemini 2.5 Flash(有标点) / mlx-whisper(离线备选)
  27. - 输出默认存:`~/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)

  1. # 视频转文字工具(VideoTranscribe)
  2. > AI 驱动的视频/音频转录工具。有字幕抓字幕,没字幕用 AI 听写——YouTube、B站、本地文件全支持。
  3. ## 功能
  4. - **本地文件转录**:MP4、MOV、MP3、M4A 等,ffmpeg 自动提音频
  5. - **URL 转录**:YouTube、B站、小宇宙,任何 yt-dlp 支持的平台
  6. - **字幕优先策略**:有字幕直接抓(快速、0 API 消耗),没有才下音频转录
  7. - **两种引擎**:Gemini 2.5 Flash(有标点、推荐)/ mlx-whisper(本地离线)
  8. - **内容提炼**:三种模式——快速摘要 / 结构化笔记 / 内容再创作
  9. ## 快速开始
  10. ```bash
  11. # 转录本地视频
  12. python3 Tools/transcribe.py --input "video.mp4"
  13. # 转录 YouTube 视频
  14. python3 Tools/transcribe.py --input "https://youtu.be/xxx"
  15. # 转录 B站视频
  16. python3 Tools/transcribe.py --input "https://www.bilibili.com/video/BVxxx"
  17. # 使用本地 mlx-whisper(离线)
  18. python3 Tools/transcribe.py --input "video.mp4" --engine mlx
  19. # 指定输出路径
  20. python3 Tools/transcribe.py --input "video.mp4" --output ~/Desktop/result.txt
  21. ```
  22. ## 依赖安装
  23. ```bash
  24. # 必需
  25. pip3 install google-genai # Gemini 引擎(推荐)
  26. brew install yt-dlp ffmpeg # 音频处理
  27. # 可选(本地离线引擎)
  28. pip3 install mlx-whisper # 仅 Apple Silicon
  29. ```
  30. ## API Key 配置
  31. Gemini 引擎需要 API Key,从 [Google AI Studio](https://aistudio.google.com/) 免费申请:
  32. ```bash
  33. # 方式一:环境变量
  34. export GEMINI_API_KEY="your-key"
  35. # 方式二:写入文件(PAI 用户推荐)
  36. echo 'GEMINI_API_KEY=your-key' >> ~/.shared-skills/api-registry/.env
  37. ```
  38. ## 引擎对比
  39. | 引擎 | 命令 | 优点 | 缺点 |
  40. |------|------|------|------|
  41. | `gemini`(默认)| `--engine gemini` | 有标点、可读性好、速度快 | 需网络 + API Key |
  42. | `mlx` | `--engine mlx` | 完全离线、免费 | 无标点、仅 Apple Silicon |
  43. ## 接入各类 AI Agent
  44. ### 直接调用(所有平台通用)
  45. 任何 AI Agent 只需运行 `run.sh` 或直接调 Python 脚本:
  46. ```bash
  47. # 通用入口(推荐)
  48. bash /path/to/VideoTranscribe/run.sh --input "video.mp4"
  49. # 或直接调脚本
  50. python3 /path/to/VideoTranscribe/Tools/transcribe.py --input "video.mp4"
  51. ```
  52. ### Claude Code
  53. 将此目录放入 `~/.shared-skills/`,直接用自然语言触发:
  54. > "帮我把这个视频转成文字"
  55. > "把这个 YouTube 链接的内容转录出来"
  56. ### OpenClaw / Codex / Gemini CLI
  57. 在 agent 的工具调用或 bash 执行里直接写:
  58. ```bash
  59. bash ~/.shared-skills/VideoTranscribe/run.sh --input "{{ input_url_or_path }}"
  60. ```
  61. 脚本会自动加载 Gemini API Key 并返回转录结果。
  62. ## 文件结构
  63. ```
  64. VideoTranscribe/
  65. ├── SKILL.md # Claude Code skill 入口
  66. ├── Workflows/
  67. │ ├── Transcribe.md # 转录流程
  68. │ └── Extract.md # 提炼流程(3种模式)
  69. └── Tools/
  70. └── transcribe.py # 核心脚本
  71. ```
  72. ## License
  73. MIT
  74. ---
  75. ## 📱 关注作者 / Follow Me
  76. 如果这个仓库对你有帮助,欢迎关注我。后面我会持续更新更多 AI Skill、视频转字、字幕生成和内容处理工作流。
  77. If this repo helped you, follow me for more AI skills, video transcription, subtitle generation, and content workflows.
  78. - X (Twitter): [@xiaoerzhan](https://x.com/xiaoerzhan)
  79. - 微信公众号 / WeChat Official Account: 扫码关注 / Scan to follow
  80. <p align="center">
  81. <img src="./follow-wechat-qrcode.jpg" alt="Jane WeChat Official Account QR code" width="300" />
  82. </p>
  83. <p align="center"><strong>中文:</strong>欢迎关注我的公众号,一起研究 AI Skill、视频转字、字幕生成和内容工作流。</p>
  84. <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 in

Free to use. If it’s helped, pass it on.