edge-tts
- Use it when:
- You say "tts" or want a reply spoken, say while driving or cooking, or need a particular voice, speed, pitch or format.
- It does:
- Runs uvx edge-tts on the text, which uses Microsoft Edge's neural text-to-speech service.
- You get:
- An MP3 in a temporary folder, with subtitles if you ask.
- Voices:
- 33 listed English, French and Chinese voices, including two Chinese dialects, plus the command that lists the rest.
- Needs:
- uv, for its uvx command.
TL;DR
A short skill that gives the agent the edge-tts commands it needs. It writes audio with --write-media, adds subtitles with --write-subtitles, changes speed and volume with percentages such as --rate=+50%, pitch in hertz, and the voice with --voice, such as zh-CN-XiaoxiaoNeural. The SKILL.md lists each voice's gender, content categories, such as news or conversation, and personality, such as warm or cheerful, and edge-tts --list-voices shows every other voice. The text is spoken by Microsoft's service, not a local model.
Summarizes the skill at 47edd62.
npx skills add https://github.com/aahl/skills --skill edge-tts Fewer weekly downloads than 66% of skills
Weekly values
| Week to | Installs |
|---|---|
| Sep 21 | 120 |
| Sep 28 | 122 |
| Oct 5 | 133 |
| Oct 12 | 151 |
| Oct 19 | 158 |
| Oct 26 | 163 |
| Nov 2 | 208 |
| Nov 9 | 170 |
Fewer downloads than 58% of skills
Fewer stars than 96% of repos
Older than 70% of skills
| Category |
Generate and edit video, images and audio. |
|---|---|
| Type |
Operates a CLI, API, app or bundled script to get something done. |
| Effect |
Its own steps create or change files, git state or local tools. |
| Needs |
A specific command-line tool or desktop app must be installed, such as gh, agent-browser, LibreOffice, Obsidian or a vendor CLI. |
| Publisher |
Everyone else. Unverified vendor claims default to community. |
| Topics | |
| Stack |
SKILL.md
From aahl/skills at 47edd62. Checked daily, last changed Nov 6, 2026.
Frontmatter
name: edge-tts
description: 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.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