speak

Converts text to speech using edge-tts neural voices with macOS say fallback.

Updated Feb 28, 2026
One-click install
npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill speak-heman1033p-create
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speak
Source: https://github.com/heman1033p-create/cv-v2-kongphop/tree/main/.gemini/skills/speak
Command: npx skills add https://github.com/heman1033p-create/cv-v2-kongphop --skill speak-heman1033p-create

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires edge-tts, and includes scripts (resource) components.

What problem does it solve? Reading long text responses on screen is slow and impractical when multitasking or working hands-free. This Skill converts any text into spoken audio so you can listen to responses, notifications, or content aloud. ## Core Features & Use Cases - Neural Text-to-Speech: Uses edge-tts with high-quality neural voices for English and Thai, with male and female voice options. - Automatic Fallback: Falls back to the built-in macOS say command when edge-tts is not installed. - Voice Discovery: Lists all available edge-tts and macOS voices so you can pick the right one. - Use Case: After receiving a long AI-generated summary, ask for it to be read aloud in a British English voice while you continue working on something else. ## Quick Start Ask the assistant to speak the text "Hello world" aloud using the default voice.

Frequently Asked Questions about speak

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

FAQPage Schema
How do I convert text to speech from the command line?▼

Run the speak script with Bun followed by your text in quotes, for example bun speak.ts "Hello world". It uses edge-tts neural voices when available and falls back to the macOS say command otherwise.

How do I use edge-tts for Thai text-to-speech?▼

Pass the --thai flag with your Thai text, such as bun speak.ts --thai "สวัสดีครับ". This selects the th-TH-NiwatNeural male voice by default, or th-TH-PremwadeeNeural when combined with the --female flag.

Does edge-tts work without an internet connection?▼

No, edge-tts requires internet access because it uses Microsoft's online neural voice service. When edge-tts is unavailable or fails, the script falls back to the macOS say command, which works offline.

How do I list available text-to-speech voices on macOS?▼

Run the script with the --list flag to display available voices. It shows filtered edge-tts neural voices for English and Thai plus macOS system voices from the say -v ? command.

Why does text-to-speech fall back to macOS say?▼

Fallback happens when edge-tts is not installed or when the edge-tts command exits with an error. Install it with pip install edge-tts to use neural voices, or pass --mac to force the built-in say command.