free-tts

Convert text to MP3 speech audio using the edge-tts command-line tool.

1|Updated Jun 20, 2026
One-click install
npx skills add https://github.com/riipandi/minis-skills --skill free-tts-riipandi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: free-tts
Source: https://github.com/riipandi/minis-skills/tree/main/free-tts
Command: npx skills add https://github.com/riipandi/minis-skills --skill free-tts-riipandi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires edge-tts.

What problem does it solve? It turns written text into playable MP3 audio without requiring any API key, account registration, or payment, making text-to-speech instantly available for reading content aloud. ## Core Features & Use Cases - Free Speech Synthesis: Uses edge-tts (Microsoft Edge online TTS) with zero configuration, zero cost, and unlimited usage. - Multilingual Voice Selection: Offers 14 Chinese voices covering Mandarin, Cantonese, Taiwan Mandarin, and regional dialects, plus full multilingual voices via edge-tts --list-voices. - Adjustable Playback Parameters: Control speech rate, volume, and pitch with simple percentage or Hz adjustments. - Use Case: A user pastes a long article and says "read it aloud" — the skill synthesizes the text into an MP3 file and returns a clickable audio link for immediate playback. ## Quick Start Ask the assistant to read the provided text aloud and it will generate a playable MP3 audio file using the default Xiaoxiao voice.

Frequently Asked Questions about free-tts

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert text to speech for free without an API key?

Install the edge-tts Python package and run it with a --text argument and --write-media output path. It calls the Microsoft Edge online TTS API, which requires no API key, account, or payment.

How to use edge-tts to generate an MP3 audio file?

Run edge-tts with --text for the content and --write-media for the output MP3 path, optionally adding --voice, --rate, --volume, and --pitch. Synthesis takes about 1-2 seconds per sentence and outputs 24kHz 160kbps MP3.

What Chinese voices does edge-tts support?

edge-tts offers 14 Chinese voices including Mandarin (Xiaoxiao, Yunxi, Yunjian), Cantonese (HiuGaai, WanLung), Taiwan Mandarin (HsiaoChen, YunJhe), and dialects like Dongbei and Shaanxi. Run edge-tts --list-voices for the full multilingual list.

Does edge-tts work offline or require internet?

edge-tts requires an internet connection because it performs cloud synthesis through the Microsoft Edge online TTS API. It cannot generate speech audio without network access.

How do I change speech rate and volume in edge-tts?

Pass --rate and --volume as percentage adjustments, such as --rate=+20% or --volume=+50%, with a range from -50% to +100%. Pitch can be adjusted with --pitch in Hz, for example --pitch=+10Hz.