# Send video-audio-replace to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "video-audio-replace",
    "name": "video-audio-replace",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/synthere/video-audio-replace",
    "canonicalUrl": "https://clawhub.ai/synthere/video-audio-replace",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/video-audio-replace",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-audio-replace",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "generate_subtitles.py",
      "replace.py",
      "SKILL.md",
      "video-audio-replace.sh",
      "_meta.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "video-audio-replace",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T05:41:47.064Z",
      "expiresAt": "2026-05-12T05:41:47.064Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-audio-replace",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=video-audio-replace",
        "contentDisposition": "attachment; filename=\"video-audio-replace-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "video-audio-replace"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/video-audio-replace"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/video-audio-replace",
    "downloadUrl": "https://openagent3.xyz/downloads/video-audio-replace",
    "agentUrl": "https://openagent3.xyz/skills/video-audio-replace/agent",
    "manifestUrl": "https://openagent3.xyz/skills/video-audio-replace/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/video-audio-replace/agent.md"
  }
}
```
## Documentation

### Video Audio Replace

Replace a video's original audio with TTS-generated voice while maintaining precise timing alignment. Also supports generating subtitles from video using Whisper.

### Step 1: Generate subtitles from video (optional)

If you don't have an SRT file, generate one from the video using the included script:

# Generate subtitles from video (uses faster-whisper, free, local)
generate_subtitles.py video.mp4 -o subtitles.srt -l zh

Or manually with Python:

# Using faster-whisper (recommended, local, free)
pip install faster-whisper srt

python3 << 'EOF'
from faster_whisper import WhisperModel
import srt
from datetime import timedelta

model = WhisperModel("base", device="cpu", compute_type="int8")
segments, info = model.transcribe("input_video.mp4", language="zh")

# Generate SRT
def format_time(seconds):
    td = timedelta(seconds=seconds)
    return f"{td.seconds//3600:02d}:{(td.seconds%3600)//60:02d}:{td.seconds%60:02d},{td.microseconds//1000:03d}"

srt_content = ""
for i, seg in enumerate(segments, 1):
    start = format_time(seg.start)
    end = format_time(seg.end)
    srt_content += f"{i}\\n{start} --> {end}\\n{seg.text.strip()}\\n\\n"

with open("subtitles.srt", "w", encoding="utf-8") as f:
    f.write(srt_content)
EOF

### Step 2: Replace audio with TTS

Use the generated SRT to create a new video with TTS voice.

### When to use

Dubbing videos with AI-generated voice
Converting subtitle files to voice-over
Creating multilingual video versions

### API Keys (choose one)

ElevenLabs: Set ELEVENLABS_API_KEY environment variable
Edge TTS (free, no key needed): Use --engine edge

### System dependencies

ffmpeg
sox (optional, for advanced processing)

### Basic usage (ElevenLabs)

video-audio-replace --video input.mp4 --srt subtitles.srt --output output.mp4 --voice "Liam"

### Using Edge TTS (free, no API key)

video-audio-replace --video input.mp4 --srt subtitles.srt --output output.mp4 --engine edge --voice "zh-CN-YunxiNeural"

### Options

OptionDescriptionDefault--videoInput video fileRequired--srtSRT subtitle fileRequired--outputOutput video fileinput_tts.mp4--voiceVoice ID or nameLiam (ElevenLabs)--engineTTS engine: elevenlabs, edgeelevenlabs--speed-rangeSpeed adjustment range0.85-1.15

### English voice (ElevenLabs)

video-audio-replace --video 2028.mp4 --srt 2028.srt --output 2028_final.mp4 --voice "Liam"

### Chinese voice (Edge TTS)

video-audio-replace --video video.mp4 --srt subs.srt --output result.mp4 --engine edge --voice "zh-CN-YunxiNeural"

### How it works

Extract original audio from video
Split audio into segments based on subtitle timestamps
Generate TTS audio for each subtitle segment
Adjust TTS speed (within 0.85-1.15x) to match original segment duration
Add silence padding to fill any remaining time gap
Merge all segments preserving original timing gaps
Replace video audio with aligned TTS audio

### ElevenLabs (require API key)

Liam - Energetic male (recommended)
Sarah - Professional female
Brian - Deep resonant male
Run curl with your API key to list all voices

### Edge TTS (free)

Chinese: zh-CN-XiaoxiaoNeural, zh-CN-YunxiNeural, zh-CN-YunyangNeural
English: en-US-JennyNeural, en-US-GuyNeural
Many more languages available
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: synthere
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T05:41:47.064Z
- Expires at: 2026-05-12T05:41:47.064Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/video-audio-replace)
- [Send to Agent page](https://openagent3.xyz/skills/video-audio-replace/agent)
- [JSON manifest](https://openagent3.xyz/skills/video-audio-replace/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/video-audio-replace/agent.md)
- [Download page](https://openagent3.xyz/downloads/video-audio-replace)