# tts

Turns text and documents into speech audio, with subtitle-timed output and voice references. Use it for narration, dubbing, or spoken versions of written material.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4300 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/tts/SKILL.md
- Updated: 2026-09-28
- HTML: https://affpapa.org/en/nevibecode/skills/tts

## What it does

This skill generates speech from text or files through local Kokoro or the Noiz cloud backend. It can process text, EPUB, PDF, and SRT inputs, write MP3, OGG, or Opus output, and use a reference recording for voice cloning.

For timed audio, it creates an SRT file, applies a JSON voice map to individual segments or ranges, then renders the track. `ffmpeg` is used only for `render`, while the Noiz backend requires the `requests` package. Kokoro runs locally without network access.

When no API key is configured, the script switches to Noiz guest mode with voice, speed, and format controls. It excludes voice cloning, emotion controls, segment duration, and timeline rendering. Text and optional reference audio reach Noiz only when you run its backend, so review the material you send to the cloud.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install NoizAI/skills tts
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add NoizAI/skills --skill tts -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/tts/SKILL.md

## When to use it
- turn written text into audio
- make spoken EPUB, PDF, or SRT files
- clone a voice from a reference recording
- align speech with subtitle segments
- assign voices to selected segments

## Example prompts
- Read `article.txt` aloud and save the result as `out.mp3`.
- Create `article.srt` from `article.txt`, then render timed audio from it.
- Generate audio using `./ref.wav` as the voice reference and save it to `clone.wav`.

## Similar
- [elevenlabs-tts](https://affpapa.org/en/nevibecode/skills/glebis-elevenlabs-tts.md) — skill · 305 installs
- [google-tts](https://affpapa.org/en/nevibecode/skills/google-tts.md) — skill · 334 installs
- [qianwen-audio-tts](https://affpapa.org/en/nevibecode/skills/qianwen-audio-tts.md) — skill · 5600 installs
- [sherpa-onnx-tts](https://affpapa.org/en/nevibecode/skills/sherpa-onnx-tts.md) — skill · 5300 installs
- [zai-tts](https://affpapa.org/en/nevibecode/skills/zai-tts.md) — skill · 2800 installs
- [qwencloud-audio-tts](https://affpapa.org/en/nevibecode/skills/qwencloud-audio-tts.md) — skill · 1600 installs

## Other versions with the same name
- [tts · marswaveai](https://affpapa.org/en/nevibecode/skills/marswaveai-tts.md) — 1400 installs

From the same set: [noizai/skills](https://affpapa.org/en/nevibecode/by/noizai/skills.md) — 7 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