🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
πŸ¦€ ClawHub

Mac TTS

by @kalijason

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.

Versionv1.0.0
Downloads6,761
Installs49
Stars⭐ 2
TERMINAL
clawhub install mac-tts

πŸ“– About This Skill


name: mac-tts description: 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.

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)

| Voice | Description | |-------|-------------| | 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
  • ⚑ When to Use

    TriggerAction
    - **提醒**: `say -v "Meijia" "ζœƒθ­°ε³ε°‡ι–‹ε§‹"`
    - **θ­¦ε‘Š**: `say -v "Meijia" "ζ³¨ζ„οΌŒζœ‰ζ–°ηš„η·Šζ€₯訊息"`

    πŸ“‹ Tips & Best Practices

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