Xpersona
E

Edge TTS

CLAWHUB · Unverified

Text-to-speech conversion using node-edge-tts npm package for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.

62
Rank
84
Safety
23k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 23K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s174g0b36b6s6mynzh70wmxp5h885pyw:edge-tts
  1. Install using `clawhub skill install s174g0b36b6s6mynzh70wmxp5h885pyw:edge-tts` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/i3130002/edge-tts before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-i3130002-edge-tts-edge-tts-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

37,774 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: edge-tts
description: |
  Text-to-speech conversion using node-edge-tts npm package for generating audio from text.
  Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation.
  Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.
---

# Edge-TTS Skill

## Overview

Generate high-quality text-to-speech audio using Microsoft Edge's neural TTS service via the node-edge-tts npm package. Supports multiple languages, voices, adjustable speed/pitch, and subtitle generation.

## Quick Start

When you detect TTS intent from triggers or user request:

1. **Call the tts tool** (Clawdbot built-in) to convert text to speech
2. The tool returns a MEDIA: path
3. Clawdbot routes the audio to the current channel

```javascript
// Example: Built-in tts tool usage
tts("Your text to convert to speech")
// Returns: MEDIA: /path/to/audio.mp3
```

## Trigger Detection

Recognize "tts" keyword as TTS requests. The skill automatically filters out TTS-related keywords from text before conversion to avoid converting the trigger words themselves to audio.

## Advanced Customization

### Using the Node.js Scripts

For more control, use the bundled scripts directly:

#### TTS Converter
```bash
cd scripts
npm install
node tts-converter.js "Your text" --voice en-US-AriaNeural --rate +10% --output output.mp3
```

**Options:**
- `--voice, -v`: Voice name (default: en-US-AriaNeural)
- `--lang, -l`: Language code (e.g., en-US, es-ES)
- `--format, -o`: Output format (default: audio-24khz-48kbitrate-mono-mp3)
- `--pitch`: Pitch adjustment (e.g., +10%, -20%, default)
- `--rate, -r`: Rate adjustment (e.g., +10%, -20%, default)
- `--volume`: Volume adjustment (e.g., +0%, -10%, default)
- `--save-subtitles, -s`: Save subtitles as JSON file
- `--output, -f`: Output file path (default: tts_output.mp3)
- `--proxy, -p`: Proxy URL (e.g., http://localhost:7890)
- `--timeout`: Request timeout in milliseconds (default: 10000)
- `--list-voices, -L`: List available voices

#### Configuration Manager
```bash
cd scripts
npm install
node config-manager.js --set-voice en-US-AriaNeural

node config-manager.js --set-rate +10%

node config-manager.js --get

node config-manager.js --reset
```

### Voice Selection

Common voices (use `--list-voices` for full list):

**English:**
- `en-US-MichelleNeural` (female, natural, **default**)
- `en-US-AriaNeural` (female, natural)
- `en-US-GuyNeural` (male, natural)
- `en-GB-SoniaNeural` (female, British)
- `en-GB-RyanNeural` (male, British)

**Other Languages:**
- `es-ES-ElviraNeural` (Spanish, Spain)
- `fr-FR-DeniseNeural` (French)
- `de-DE-KatjaNeural` (German)
- `ja-JP-NanamiNeural` (Japanese)
- `zh-CN-XiaoxiaoNeural` (Chinese)
- `ar-SA-ZariyahNeural` (Arabic)

### Rate Guidelines

Rate values use percentage format:
- 

_meta.json

{
  "ownerId": "kn7ay2qcqva8ek62e2yrgnjevn7ztee6",
  "slug": "edge-tts",
  "version": "2.0.0",
  "publishedAt": 1769456031010
}

references/node_edge_tts_guide.md

# node-edge-tts Reference

node-edge-tts is a Node.js module that utilizes Microsoft Edge's online TTS (Text-to-Speech) service. It supports multiple voices, languages, and audio formats.

## Installation

```bash
npm install node-edge-tts
# or
npx node-edge-tts -t "Hello world"
```

## Core Concepts

### Voices

node-edge-tts provides access to Microsoft Edge's neural voices. Voice names follow this pattern:
- `en-US-AriaNeural` - English (US), female voice
- `en-US-GuyNeural` - English (US), male voice
- `es-ES-ElviraNeural` - Spanish (Spain), female voice

Format: `{language_code}-{region_code}-{Name}{VoiceType}`

### Output Formats

node-edge-tts supports various output formats for audio quality:
- `audio-24khz-48kbitrate-mono-mp3` - 24kHz, 48kbps, mono MP3 (default)
- `audio-24khz-96kbitrate-mono-mp3` - 24kHz, 96kbps, mono MP3 (higher quality)
- `audio-48khz-96kbitrate-stereo-mp3` - 48kHz, 96kbps, stereo MP3 (highest quality)

## Common Voice Names

### English
- `en-US-AriaNeural` (female, natural, recommended)
- `en-US-GuyNeural` (male, natural)
- `en-GB-SoniaNeural` (female, British)
- `en-GB-RyanNeural` (male, British)

### Spanish
- `es-ES-ElviraNeural` (female, Spain)
- `es-MX-DaliaNeural` (female, Mexico)

### French
- `fr-FR-DeniseNeural` (female)
- `fr-FR-HenriNeural` (male)

### German
- `de-DE-KatjaNeural` (female)
- `de-DE-ConradNeural` (male)

### Asian Languages
- `ja-JP-NanamiNeural` (Japanese, female)
- `zh-CN-XiaoxiaoNeural` (Chinese, female)
- `ko-KR-SunHiNeural` (Korean, female)

### Arabic
- `ar-SA-ZariyahNeural` (female)
- `ar-SA-HamedNeural` (male)

## Usage Patterns

### Command Line Usage

```bash
# Basic usage
npx node-edge-tts -t "Hello world" -f output.mp3

# With voice and language
npx node-edge-tts -t "Hello world" -v en-US-AriaNeural -l en-US -f output.mp3

# With pitch and rate
npx node-edge-tts -t "Hello world" --rate "+10%" --pitch "-10%" -f output.mp3

# With subtitles
npx node-edge-tts -t "Hello world" -f output.mp3 -s
```

### Module Usage

```javascript
const { EdgeTTS } = require('node-edge-tts');

async function generateSpeech(text, outputFile) {
  const tts = new EdgeTTS({
    voice: 'en-US-AriaNeural',
    lang: 'en-US',
    outputFormat: 'audio-24khz-48kbitrate-mono-mp3',
    pitch: 'default',
    rate: 'default',
    volume: 'default',
  });

  await tts.ttsPromise(text, outputFile);
}

generateSpeech('Hello world!', 'output.mp3');
```

### With Options

```javascript
const { EdgeTTS } = require('node-edge-tts');

async function generateSpeech(text, outputFile) {
  const tts = new EdgeTTS({
    voice: 'en-US-AriaNeural',
    lang: 'en-US',
    outputFormat: 'audio-24khz-96kbitrate-mono-mp3',
    saveSubtitles: true,
    proxy: 'http://localhost:7890',
    timeout: 10000,
    pitch: '+10%',
    rate: '+20%',
    volume: '-10%',
  });

  await tts.ttsPromise(text, outputFile);
  // Subtitles saved to output.json
}
```

## Prosody Options

### Rate (Speed)
Control speech speed with percentage adjustmen

scripts/package-lock.json

{
  "name": "edge-tts-scripts",
  "version": "2.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "edge-tts-scripts",
      "version": "2.0.0",
      "license": "MIT",
      "dependencies": {
        "commander": "^11.0.0",
        "node-edge-tts": "^1.2.9"
      }
    },
    "node_modules/agent-base": {
      "version": "7.1.4",
      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
      "license": "MIT",
      "engines": {
        "node": ">= 14"
      }
    },
    "node_modules/ansi-regex": {
      "version": "5.0.1",
      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
      "license": "MIT",
      "engines": {
        "node": ">=8"
      }
    },
    "node_modules/ansi-styles": {
      "version": "4.3.0",
      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
      "license": "MIT",
      "dependencies": {
        "color-convert": "^2.0.1"
      },
      "engines": {
        "node": ">=8"
      },
      "funding": {
        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
      }
    },
    "node_modules/cliui": {
      "version": "8.0.1",
      "resolved": "https://registry.npmjs.org/cliui/-/cliui-8.0.1.tgz",
      "integrity": "sha512-BSeNnyus75C4//NQ9gQt1/csTXyo/8Sb+afLAkzAptFuMsod9HFokGNudZpi/oQV73hnVK+sR+5PVRMd+Dr7YQ==",
      "license": "ISC",
      "dependencies": {
        "string-width": "^4.2.0",
        "strip-ansi": "^6.0.1",
        "wrap-ansi": "^7.0.0"
      },
      "engines": {
        "node": ">=12"
      }
    },
    "node_modules/color-convert": {
      "version": "2.0.1",
      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
      "license": "MIT",
      "dependencies": {
        "color-name": "~1.1.4"
      },
      "engines": {
        "node": ">=7.0.0"
      }
    },
    "node_modules/color-name": {
      "version": "1.1.4",
      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
      "license": "MIT"
    },
    "node_modules/commander": {
      "version": "11.1.0",
      "resolved": "https://registry.npmjs.org/commander/-/commander-11.1.0.tgz",
      "integrity": "sha512-yPVavfyCcRhmorC7rWlkHn15b4wDVgVmBA7kV4QVBsF7kv/9TKJAbAXVTxvTnwP8HHKjRCJDClKbciiYS7p0DQ==",
      "license": "MIT",
      "engines": {
        "node": ">=16"
      }
    },
    "nod

scripts/package.json

{
  "name": "edge-tts-scripts",
  "version": "2.0.0",
  "description": "Edge-TTS converter and configuration management scripts using node-edge-tts",
  "type": "commonjs",
  "scripts": {
    "tts": "node tts-converter.js",
    "config": "node config-manager.js",
    "test": "npx node-edge-tts -t \"Hello, world! This is a test of the Edge TTS service.\" -f test-output.mp3 && echo \"Test completed successfully!\""
  },
  "dependencies": {
    "node-edge-tts": "^1.2.9",
    "commander": "^11.0.0"
  },
  "author": "Clawdbot",
  "license": "MIT"
}

Sponsored

Ads related to Edge TTS and adjacent AI workflows.