✓ Verified 💻 Development ✓ Enhanced Data

Mac Tts

Text-to-speech using macOS built-in `say` command.

Rating: 4.4 (305 reviews)
Downloads: 7,430 downloads
Version: 1.0.0

Overview

Text-to-speech using macOS built-in `say` command.

Complete Documentation

View Source →

mac-tts

Use macOS built-in say command for text-to-speech output through system speakers.

Basic Usage

bash

say "Hello, this is a test"

With Voice Selection

bash

say -v "Meijia" "你好，這是測試"      # 台灣中文 (推薦)
say -v "Tingting" "你好，这是测试"    # 簡體中文
say -v "Samantha" "Hello world"       # 英文

Common Chinese Voices (zh_TW)

Voice	Description
Meijia	美佳 - 自然女聲 (推薦)
Flo	年輕女聲
Eddy	男聲
Reed	男聲
Sandy	女聲
Shelley	女聲

List All Available Voices

bash

say -v "?"                           # 全部語音
say -v "?" | grep zh_TW              # 只列台灣中文

Volume Control

Check/adjust system volume before speaking:

bash

# Check current volume (0-100) and mute status
osascript -e "output volume of (get volume settings)"
osascript -e "output muted of (get volume settings)"

# Unmute
osascript -e "set volume without output muted"

# Set volume (0-100)
osascript -e "set volume output volume 70"

Use Cases

通知: say -v "Meijia" "外送到了"
提醒: say -v "Meijia" "會議即將開始"
警告: say -v "Meijia" "注意，有新的緊急訊息"

Notes

Runs synchronously (blocks until speech completes)
Add & for async: say "message" &
Works only on macOS

Installation

Terminal bash


openclaw install mac-tts

Copied!

💻Code Examples

say -v "Samantha" "Hello world" # 英文

say--v-samantha-hello-world--.txt

## Common Chinese Voices (zh_TW)

| Voice | Description |
|-------|-------------|
| Meijia | 美佳 - 自然女聲 (推薦) |
| Flo | 年輕女聲 |
| Eddy | 男聲 |
| Reed | 男聲 |
| Sandy | 女聲 |
| Shelley | 女聲 |

## List All Available Voices

say -v "?" | grep zh_TW # 只列台灣中文

say--v---grep-zhtw--.txt

## Volume Control

Check/adjust system volume before speaking:

example.sh

say -v "Meijia" "你好，這是測試"      # 台灣中文 (推薦)
say -v "Tingting" "你好，这是测试"    # 簡體中文
say -v "Samantha" "Hello world"       # 英文

example.sh

# Check current volume (0-100) and mute status
osascript -e "output volume of (get volume settings)"
osascript -e "output muted of (get volume settings)"

# Unmute
osascript -e "set volume without output muted"

# Set volume (0-100)
osascript -e "set volume output volume 70"