# video-translation

Translates speech in a video into another language and swaps the audio track for synthesized voice, leaving the picture untouched.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2000 installs · ★ 531
- Author: NoizAI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NoizAI/skills/tree/HEAD/skills/video-translation/SKILL.md
- Updated: 2026-09-28
- HTML: https://affpapa.org/en/nevibecode/skills/video-translation

## What it does

The skill takes a video URL, downloads the file with its subtitles as SRT, translates the lines sentence by sentence and renders a new track through TTS. The video itself stays as it was — only the audio changes.

It leans on two other skills. `youtube-downloader` fetches the video and subtitles in the source language, `tts` renders audio against the subtitle timestamps, and the Noiz backend stretches each sentence to fit the original cue. Pass the source file to `--ref-audio-track` and the engine slices the original audio at every timestamp, using those clips as the voice reference for that segment. The last step is `replace_audio.sh`, which merges video and dubbed audio; the `--srt` flag keeps the background sound between translated segments intact.

You need a `NOIZ_API_KEY` for the Noiz backend and `ffmpeg` on the machine. The `youtube-downloader` and `tts` skills have to sit in your `skills/` folder — copy them in yourself if they are not there yet. One catch worth knowing before you start: the source video must have subtitles in the original language, auto-generated ones included. Without them there is nothing to translate and the pipeline stops at step one.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill video-translation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/video-translation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/video-translation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill video-translation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/video-translation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill video-translation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/video-translation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NoizAI/skills video-translation
```

2. **Manually: put the files in place**
- File: `.github/skills/video-translation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill video-translation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/NoizAI/skills --path skills/video-translation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/video-translation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill video-translation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/NoizAI/skills/tree/HEAD/skills/video-translation/SKILL.md

## When to use it
- translate speech in a foreign video into your own language
- generate a dub that keeps the subtitle timestamps
- swap the audio track without re-encoding the video
- keep background sound outside the translated segments
- clone the speaker's voice from the original track

## Example prompts
- translate this video to English
- dub this video to Spanish
- translate the video at this link and replace the audio

## Similar
- [language-swap](https://affpapa.org/en/nevibecode/skills/language-swap.md) — skill · 1200 installs
- [video-toolkit](https://affpapa.org/en/nevibecode/skills/video-toolkit.md) — skill · 1100 installs
- [video-use](https://affpapa.org/en/nevibecode/skills/video-use.md) — skill · 5100 installs
- [video-understand](https://affpapa.org/en/nevibecode/skills/video-understand.md) — skill · 1400 installs
- [video-processing-editing](https://affpapa.org/en/nevibecode/skills/video-processing-editing.md) — skill · 1400 installs
- [beat-sync-video-editing](https://affpapa.org/en/nevibecode/skills/beat-sync-video-editing.md) — skill · 775 installs

From the same set: [noizai/skills](https://affpapa.org/en/nevibecode/by/noizai/skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md