# 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)
VoiceDescriptionMeijia美佳 - 自然女聲 (推薦)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