skilld
All skills
aahl avatar

/edge-tts

@170dba6
by aahlaahl/skills161 stars
22

Text-to-speech conversion using `uvx edge-tts` for generating audio from text. 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.

Ask your Agent

Use this Skill: https://skilld.dev/gh/aahl/skills/edge-tts

This session only. Nothing lands on disk.

SKILL.md

≈85 tokens always: the name and description. ≈971 when used: this file.

Edge-TTS

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

Usage

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3

# With subtitles
uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --write-subtitles -

Changing rate(speed), volume and pitch

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --rate=+50%
uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --volume=+50% --pitch=-50Hz

Changing the voice

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --voice zh-CN-XiaoxiaoNeural

Available voices

Name                               Gender    ContentCategories      VoicePersonalities
en-GB-LibbyNeural                  Female    General                Friendly, Positive
en-GB-RyanNeural                   Male      General                Friendly, Positive
en-GB-SoniaNeural                  Female    General                Friendly, Positive
en-GB-ThomasNeural                 Male      General                Friendly, Positive
en-HK-SamNeural                    Male      General                Friendly, Positive
en-HK-YanNeural                    Female    General                Friendly, Positive
en-US-AnaNeural                    Female    Cartoon, Conversation  Cute
en-US-AndrewMultilingualNeural     Male      Conversation, Copilot  Warm, Confident, Authentic, Honest
en-US-AndrewNeural                 Male      Conversation, Copilot  Warm, Confident, Authentic, Honest
en-US-AriaNeural                   Female    News, Novel            Positive, Confident
en-US-AvaMultilingualNeural        Female    Conversation, Copilot  Expressive, Caring, Pleasant, Friendly
en-US-AvaNeural                    Female    Conversation, Copilot  Expressive, Caring, Pleasant, Friendly
en-US-BrianMultilingualNeural      Male      Conversation, Copilot  Approachable, Casual, Sincere
en-US-BrianNeural                  Male      Conversation, Copilot  Approachable, Casual, Sincere
en-US-ChristopherNeural            Male      News, Novel            Reliable, Authority
en-US-EmmaMultilingualNeural       Female    Conversation, Copilot  Cheerful, Clear, Conversational
en-US-EmmaNeural                   Female    Conversation, Copilot  Cheerful, Clear, Conversational
en-US-EricNeural                   Male      News, Novel            Rational
en-US-GuyNeural                    Male      News, Novel            Passion
en-US-JennyNeural                  Female    General                Friendly, Considerate, Comfort
en-US-MichelleNeural               Female    News, Novel            Friendly, Pleasant
en-US-RogerNeural                  Male      News, Novel            Lively
en-US-SteffanNeural                Male      News, Novel            Rational
fr-FR-DeniseNeural                 Female    General                Friendly, Positive
fr-FR-HenriNeural                  Male      General                Friendly, Positive
zh-CN-XiaoxiaoNeural               Female    News, Novel            Warm
zh-CN-YunjianNeural                Male      Sports,  Novel         Passion
zh-CN-liaoning-XiaobeiNeural       Female    Dialect                Humorous
zh-CN-shaanxi-XiaoniNeural         Female    Dialect                Bright
zh-HK-HiuGaaiNeural                Female    General                Friendly, Positive
zh-HK-WanLungNeural                Male      General                Friendly, Positive
zh-TW-HsiaoChenNeural              Female    General                Friendly, Positive
zh-TW-YunJheNeural                 Male      General                Friendly, Positive

Retrieve all available voices using shell commands:

uvx edge-tts --list-voices

Source: SKILL.md on GitHub

Third-party checks

1 warning17d5 checks · Risk SAFE
  • Gen Agent Trust Hub17d

    The skill facilitates text-to-speech conversion by executing the 'edge-tts' package through the 'uvx' tool. It interpolates user-controlled inputs into shell commands, creating a surface for indirect prompt injection and potential shell command injection if the agent platform does not provide adequate sanitization.

  • Socket17d

    No alerts

  • Snyk17d

    Risk: LOW · No issues

  • Runlayer7mo

    1/1 file flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 170dba6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 weeks ago.

Activeupdated 7 months ago

Topics

  • text-to-speech
  • tts
  • edge-tts
  • audio
  • accessibility
  • multilingual
  • voice
  • uvx

README badge

README badge for aahl/skills/edge-tts

What it does

Converts text to speech using Microsoft Edge's neural TTS service via the `uvx edge-tts` command, supporting multiple languages, voices, and adjustable speed, pitch, and volume. Use when the user requests audio output or content needs to be spoken for accessibility or multitasking scenarios.

Generated from the current SKILL.md.

Frequently asked

What audio formats does edge-tts output?
The skill outputs MP3 files by default via the `--write-media` flag. It can also generate subtitle files using `--write-subtitles`.
Can I adjust speech speed, pitch, or volume?
Yes. Use `--rate` for speed (e.g., `+50%`), `--pitch` for pitch (e.g., `-50Hz`), and `--volume` for volume (e.g., `+50%`).
What languages and voices are supported?
The skill supports English (US, GB, HK), French, Mandarin Chinese (mainland and Taiwan), and Cantonese. Run `uvx edge-tts --list-voices` to see all available neural voices.
Does this require a local TTS engine or API key?
No. The skill uses Microsoft Edge's neural TTS service, accessed via the `edge-tts` package with no authentication required.

Generated from the current SKILL.md. These answers refresh after source changes.