← Back to Skills Marketplace
Subtitle Generator
by
sniper-one
· GitHub ↗
· v1.0.7
· MIT-0
551
Downloads
0
Stars
1
Active Installs
8
Versions
Install in OpenClaw
/install subtitle-generator
Description
当用户需要生成字幕、制作字幕、字幕对齐、ASR识别、语音转文字时使用此技能。触发词：生成字幕, 字幕生成, 制作字幕, 视频字幕, 语音识别, ASR字幕, Whisper字幕, 字幕制作, 视频转字幕, 字幕对齐, 音频转字幕, 语音转文字, 自动字幕, ASR识别, faster-whisper, subti...
Usage Guidance
This package appears to be a legitimate local subtitle generator, but be aware it may automatically create ~/.whisper-venv and run pip installs (faster-whisper/openai-whisper/ffmpeg-python) which will download and install code and possibly native wheels. If you want to be cautious: (1) inspect or run the script in an isolated environment or container, (2) ensure you have ffmpeg installed separately, (3) be prepared for potentially long installs or native compilation, and (4) note the skill expects to be run in the background and will use the OpenClaw 'system event' / message flow to notify you (it will not exfiltrate data to remote endpoints). If you need higher assurance, request a signed upstream source/homepage or run the code manually first to review behavior.
Capability Analysis
Type: OpenClaw Skill
Name: subtitle-generator
Version: 1.0.7
The subtitle-generator skill is a legitimate tool for ASR and subtitle creation using Faster-Whisper and OpenAI Whisper. It features an automated setup process in `engines/__init__.py` that creates a local virtual environment (`~/.whisper-venv`) and installs necessary dependencies via pip. The `SKILL.md` provides operational instructions for the OpenClaw agent to handle long-running tasks using background execution and system events for notifications. While the code utilizes `subprocess` to interact with `ffmpeg` and the `openclaw` CLI, these actions are consistent with the stated functionality and do not exhibit signs of malicious intent or data exfiltration.
Capability Assessment
Purpose & Capability
Name/description (subtitle/ASR) align with the included Python code: audio extraction (ffmpeg), ASR engine wrappers (faster-whisper / openai-whisper), timing alignment, and subtitle file generation. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md instructs the agent to run the bundled CLI script in background and to use openclaw events/message tools for notifications; the code implements that. One small mismatch: SKILL.md claims engines/__init__.py will auto-create the venv on first import, but the code only triggers venv creation when create_engine cannot import an engine (ensure_whisper_venv is called later). Otherwise instructions stay within the subtitle task (no file reads or env access outside the skill's scope).
Install Mechanism
No platform install spec is provided, but the code will auto-create ~/.whisper-venv and run pip install -r requirements.txt (faster-whisper, openai-whisper, ffmpeg-python) when needed. Installing PyPI packages at runtime is expected for this functionality but is a higher-impact action (downloads, possible native builds) than a pure instruction-only skill.
Credentials
The skill requests no environment variables or credentials and only uses Path.home() and standard local commands. The packages installed are proportional to ASR/subtitle generation; no unrelated secret access is requested.
Persistence & Privilege
The skill does not request always:true and does not modify other skills. It will create a per-user venv (~/.whisper-venv) and write subtitle files next to the video—these are reasonable for its purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install subtitle-generator - After installation, invoke the skill by name or use
/subtitle-generator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
清理重复表述，整合执行规则和 AI 回复模板
v1.0.6
修复：明确 system event 只唤醒 AI、发消息必须用 message 工具
v1.0.5
Add GPU Acceleration section with Apple Silicon Metal setup instructions (extra-index-url for M-series PyTorch Metal wheels). Add ffmpeg installation table for all platforms.
v1.0.4
Platform-aware Python detection: python3 on macOS/Linux, python on Windows (avoids macOS system Python 2.7). Cross-platform openclaw notification via shutil.which first, fallback to nvm path.
v1.0.3
Fix python3 hardcoded command for Windows compatibility (use shutil.which to find python/python3). Fix WHISPER_VENV_SITE path in main.py to use dynamic detection. Add ffmpeg pre-check with clear install instructions for Windows/macOS/Linux.
v1.0.2
P0: Dynamic venv Python version detection (fixes macOS compatibility). P1: Remove hardcoded cu124 (CTranslate2 handles GPU natively). P1: Add step-0 env auto-deploy note in SKILL.md.
v1.0.1
Cross-platform notifications: omit channel parameter to auto-detect current chat platform
v1.0.0
Initial release: pluggable ASR engines, auto GPU detection, bilingual documentation, 99+ language support
Metadata
Frequently Asked Questions
What is Subtitle Generator?
当用户需要生成字幕、制作字幕、字幕对齐、ASR识别、语音转文字时使用此技能。触发词：生成字幕, 字幕生成, 制作字幕, 视频字幕, 语音识别, ASR字幕, Whisper字幕, 字幕制作, 视频转字幕, 字幕对齐, 音频转字幕, 语音转文字, 自动字幕, ASR识别, faster-whisper, subti... It is an AI Agent Skill for Claude Code / OpenClaw, with 551 downloads so far.
How do I install Subtitle Generator?
Run "/install subtitle-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Subtitle Generator free?
Yes, Subtitle Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Subtitle Generator support?
Subtitle Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Subtitle Generator?
It is built and maintained by sniper-one (@aqbjqtd); the current version is v1.0.7.
More Skills