mac-tts

✓Verified·Scanned 2/18/2026

Text-to-speech using macOS built-in say command. Use for voice notifications, audio alerts, reading text aloud, or announcing messages through Mac speakers. Supports multiple languages including Chinese (Mandarin), English, Japanese, etc.

from clawhub.ai·v8b2c8dd·1.6 KB·0 installs
Scanned from 1.0.0 at 8b2c8dd · Transparency log ↗
$ vett add clawhub.ai/kalijason/mac-tts

mac-tts

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

Basic Usage

say "Hello, this is a test"

With Voice Selection

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

Common Chinese Voices (zh_TW)

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

List All Available Voices

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

Volume Control

Check/adjust system volume before speaking:

# 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