Shortcuts LibShortcuts Lib
Mac Shortcuts

mac text to speech keyboard shortcut: A practical guide for macOS

Learn how to enable and customize a mac text to speech keyboard shortcut using built-in voices, Shortcuts, and Terminal commands. Discover practical steps to read any text aloud across apps and boost your readability on macOS.

Shortcuts Lib
Shortcuts Lib Team
·5 min read
Keyboard ShortcutsCopyPasteMac Shortcuts
Read Text with Shortcuts - Shortcuts Lib
Photo by Ilya Klimenkovia Pexels
Quick AnswerDefinition

mac text to speech keyboard shortcut enables macOS to read selected text aloud using built-in spoken content features. With a global shortcut or a custom shortcut created via the Shortcuts app, you can trigger reading across apps. This quick answer introduces enabling, configuring, and using the shortcut in practice today and beyond.

Understanding mac text-to-speech keyboard shortcuts

According to Shortcuts Lib, mac text-to-speech keyboard shortcuts empower power users to read content quickly without shifting away from their keyboard. The macOS ecosystem includes built-in voices and accessibility services designed for high accuracy and comfort. In this section, we cover what a mac text-to-speech keyboard shortcut is, the core components (voice, speed, and trigger method), and how the pieces fit into a smooth workflow across apps. The examples below illustrate how to trigger speech from the terminal, scripts, or a keyboard shortcut.

Bash
say "Hello, Shortcuts Lib reader!"
Bash
say -v Victoria "This is a sample read aloud."

Notes:

  • You can adjust the voice using the -v flag.
  • The Terminal commands read the system's default voice if -v is not provided.

Using say and osascript for TTS

macOS provides several straightforward ways to read text aloud from the command line and scripts. The primary tools are the say command and osascript (to run AppleScript). You can read a single phrase, or pipe clipboard contents into speech.

Bash
osascript -e 'say "This is a test." using "Alex"'
Bash
pbpaste | say -v Alex
Python
# Python example: read clipboard or a variable via say import subprocess text = "This is a programmatic read." subprocess.run(["say", text])

Why this matters: These approaches let you bypass UI constraints and read content in code editors, terminals, or PDFs. Shortcuts Lib notes that a solid combination of Say and osascript increases accessibility and workflow efficiency.

Building a keyboard shortcut with Shortcuts app

A robust macOS workflow is to bind a keyboard shortcut to a Shortcuts action sequence: Get Selected Text -> Speak Text. This creates a portable, repeatable read-aloud routine that works across apps. Below is a representative shortcut definition (for illustration):

JSON
{ "name": "Read Selected Text", "actions": [ {"type": "GetSelectedText"}, {"type": "SpeakText", "voice": "Alex"} ], "hotkey": "Cmd+Option+S" }

How to implement in practice:

  • Open the Shortcuts app, create a new shortcut named “Read Selected Text”.
  • Add actions: Get Selected Text, then Speak Text. Choose a preferred voice and speed.
  • In Settings, bind a global keyboard shortcut (for example Cmd+Option+S) to trigger this shortcut.

This approach aligns with the mac text to speech keyboard shortcut goal and keeps the flow consistent across applications. Shortcuts Lib emphasizes keeping the binding minimal to avoid conflicts with other shortcuts.

Accessibility considerations and reliability

Accessibility features like Speak Selection or the Speech service are designed to be reliable, but results depend on app support and text availability. When you read from a document, ensure the text is selectable; some apps restrict selection while others expose the text via the clipboard. You can test with a simple phrase, switch voices, and adjust the speaking rate to improve comprehension across long documents. For developers, consider exposing a small API or clipboard-based interface to read content programmatically.

Bash
say -v "Samantha" "Accessibility test text"
Bash
osascript -e 'set theText to the clipboard' -e 'say theText using "Samantha"'

Shortcuts Lib notes that a well-chosen voice and rate can dramatically improve readability in technical content, code comments, or documentation. If you are integrating TTS into apps, ensure you handle permissions and respect user privacy when reading clipboard data.

Troubleshooting and best practices

If nothing reads, verify that you have a compatible voice installed and your shortcut is active. List available voices with:

Bash
say -v ?

Try a minimal test phrase with a known voice to isolate issues:

Bash
say -v Bella "Test reading with Bella voice"

If you depend on selection in browsers or editors, ensure the app allows text extraction; otherwise, rely on copying text to the clipboard and reading from there. A small script in Python or Bash often helps wrap text sources into a consistent TTS call, enabling predictable behavior across platforms.

Advanced usage: reading clipboard and selection across apps

In practice, you may want to combine selection extraction with clipboard fallbacks. The following demonstrates a workflow that reads the current selection if available, otherwise reads clipboard contents:

Bash
# Pseudocode for a robust fallback strategy if xsel -p | grep -q .; then # If a selection exists, read it echo "Reading selection"; pbpaste | say -v Alex else # Fallback to clipboard echo "Reading clipboard"; pbpaste | say -v Alex fi
Python
# Python fallback for reading text from clipboard on macOS import subprocess text = subprocess.check_output(["pbpaste"]).decode("utf-8").strip() subprocess.run(["say", text])

This kind of resilience is valuable when you need consistent TTS behavior across apps with different text-selection semantics.

Steps

Estimated time: 20-40 minutes

  1. 1

    Enable system voices

    Open System Settings > Accessibility > Spoken Content (or Voice) and turn on Speak Selection. Pick a default voice that offers clear pronunciation for your typical text.

    Tip: Choose a voice with good cadence for longer reads.
  2. 2

    Create a shortcut: Get Selected Text → Speak Text

    In Shortcuts, create a new shortcut named 'Read Selected Text' with actions Get Selected Text and Speak Text. Save the shortcut and test with sample text.

    Tip: Test with both short sentences and longer paragraphs to verify reliability.
  3. 3

    Assign a global keyboard shortcut

    In the Shortcuts app, bind a keyboard trigger such as Cmd+Option+S to start reading. Ensure there are no conflicts with existing shortcuts.

    Tip: Keep the hotkey simple and memorable to improve adoption.
  4. 4

    Test across apps

    Try the shortcut in a browser, a code editor, and a PDF viewer to confirm text extraction and reading behavior are consistent.

    Tip: If some apps restrict selection, rely on the clipboard fallback.
  5. 5

    Customize voice and speed

    Experiment with different voices and speaking rates to optimize readability for your content type.

    Tip: For dense technical content, slower speed often improves comprehension.
  6. 6

    Troubleshooting

    If the shortcut doesn’t read text, verify permissions, voices installed, and that the global hotkey is active.

    Tip: Check for app-specific restrictions on text extraction.
Pro Tip: Choose a high-clarity voice for code and dense text.
Warning: Avoid reading sensitive data aloud on shared devices.
Note: The 'say' command respects the system voice; customize via -v to pick a voice.

Prerequisites

Required

  • macOS 12+ (Monterey) or later
    Required
  • Shortcuts app or System Settings access to Keyboard Shortcuts
    Required
  • Basic command line knowledge
    Required

Optional

  • Access to clipboard and text you intend to read
    Optional
  • Option to customize voice and speed (voice packs installed)
    Optional

Keyboard Shortcuts

ActionShortcut
Speak selected textGlobal shortcut mapped via Shortcuts app or App Shortcuts to trigger 'Speak Text' action.Ctrl+⌥+S
Stop speakingStops current speech; ensure mapping exists.Ctrl+⌥+Esc
Read clipboardReads text currently in the clipboard using a custom short.Ctrl+⇧+V

Questions & Answers

What is a mac text-to-speech keyboard shortcut?

A mac text-to-speech keyboard shortcut reads highlighted or selected text aloud using built-in macOS voices. You can trigger it with a global shortcut or a Shortcuts workflow bound to a key combination.

A mac text-to-speech shortcut reads selected text aloud using your chosen voice. You can trigger it with a keyboard shortcut.

How do I create a shortcut that reads selected text?

Open the Shortcuts app, create a new shortcut with actions: Get Selected Text and Speak Text. Then assign a global keyboard trigger so you can read text with a hotkey.

Create a shortcut with Get Selected Text and Speak Text, then bind a keyboard shortcut.

Can I customize the voice and speaking rate?

Yes. In Shortcuts' Speak Text action or via the 'say' command, you can specify a voice and adjust the speed for easier reading.

You can choose a voice and speed in the Speak Text action or with the say command.

What if the shortcut doesn't read text in a particular app?

Some apps block selection extraction. In those cases, rely on 'Copy' to clipboard and read from clipboard, or adjust permissions.

Some apps block text extraction; use clipboard as a fallback.

Is there a universal global shortcut for Speak Selection?

macOS doesn't provide a universal global shortcut for Speak Selection across all apps by default; you can create one via Shortcuts or App Shortcuts.

There isn't a single universal hotkey; you can create one via Shortcuts.

Main Points

  • Enable a global TTS shortcut for macOS.
  • Use Shortcuts to combine Get Selected Text and Speak Text.
  • Test voices and speeds for readability.
  • Read text across apps with clipboard integration.
  • Customize and troubleshoot with simple commands.

Related Articles

← More in Mac Shortcuts