macos-say
Use macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output.
When & Why to Use This Skill
The macos-say skill integrates the native macOS text-to-speech engine into the Claude environment, allowing for seamless conversion of text into spoken audio. It solves the need for eyes-free feedback and automated audio generation by providing a programmable interface for the system's 'say' command, supporting multiple voices, adjustable speech rates, and direct audio file export.
Use Cases
- Task Completion Alerts: Set up spoken notifications to alert you when long-running background processes, such as code builds or data processing, are finished.
- Accessibility & Multitasking: Convert long text blocks or documentation into speech, allowing you to listen to information while performing other visual tasks.
- Audio Content Creation: Generate high-quality voiceovers and narration for scripts or presentations by exporting text directly to AAC or audio files using various system voices.
- Interactive Debugging: Implement voice feedback in scripts to announce status updates or error states without needing to constantly monitor the terminal output.
| name | macos-say |
|---|---|
| description | Use macOS text-to-speech via the `say` command for voice feedback, audio narration, and spoken output. |
macOS Say Command
Provide voice feedback using macOS's built-in say command.
Basic Usage
say "Hello, world"
Key Options
-v <voice>- Select voice (e.g., Samantha, Alex, Daniel)-r <rate>- Words per minute (default ~175)-o <file>- Output to audio file-f <file>- Read text from file
Common Patterns
say "Task complete" & # Non-blocking notification say -v Daniel "Build finished" # Specific voice say -o out.m4a --data-format=aac "Save as audio"
List voices: say -v ?