Skip to main content

Macos Say Tts

@mgreten/macos-say-ttsv2026.10.30.2· MIT· 1d agoBEHAVIORS
01README

Speak text aloud on macOS using the built-in say voice synthesizer. One focused method: synthesize text to audio and play it through the speakers, with optional voice and speech-rate control. Zero external dependencies — uses only the native macOS say and afplay binaries.

02Behaviors1
@mgreten/macos-say-ttsv2026.07.16.1macos_say_tts.ts

Global Arguments

ArgumentTypeDescription
voice?stringDefault `say` voice name (e.g. 'Samantha'). Omit to use the macOS
rate?numberDefault speech rate in words per minute. Omit to use the system default
fn speak(text: string, voice?: string, rate?: number, play?: boolean)
Synthesize text with macOS `say` and play it through the speakers
ArgumentTypeDescription
textstringThe text to speak aloud
voice?string`say` voice name; overrides the instance default for this call
rate?numberSpeech rate in words per minute; overrides the instance default
play?booleanPlay the audio through the speakers (set false to only synthesize)

Resources

utterance(7d)— Record of a spoken (or synthesized) utterance
03Previous Versions4
2026.10.14.1MIT(was none)
2026.07.16.1

Rebuild against swamp CLI 20260716

2026.06.27.1

Added 1, removed 1 behaviors

2026.06.03.1
04Stats
A
100 / 100
Downloads
32
Archive size
6.0 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Docs keep secrets in a vault1/1earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
05Platforms