Automation

SpeakWith has two recorders you can drive from outside the app: Live dictation (real-time, finalised at each pause) and Live audio (voice-activated). You can start, stop, and control either one from the command line, a macOS Shortcut, Automator, or a hotkey launcher — with no extra setup. There are two equivalent ways to send a command: the speakwith:// URL scheme (simplest) and AppleScript (for scripting environments that prefer it).

Quick start: start recording

The fastest way to begin a take is the URL scheme — one line any shell can run. Start the Live dictation recorder:

open "speakwith://live-dictation/start"

Prefer AppleScript? This does the same thing:

osascript -e 'tell application "SpeakWith" to start recording recorder live dictation'

Start the Live audio (voice-activated) recorder instead:

open "speakwith://batch/start"

Stop the current take (the microphone stays powered on, ready to start again):

open "speakwith://live-dictation/stop"

Full command reference

Each recorder supports five actions. The table below shows the Live dictation recorder. For the Live audio recorder, replace “live dictation” with “batch” in the AppleScript command, and “live-dictation” with “batch” in the URL.

ActionAppleScript commandURL scheme
Power on (microphone only)power on recorder live dictationspeakwith://live-dictation/power-on
Power off (release the microphone)power off recorder live dictationspeakwith://live-dictation/power-off
Start a takestart recording recorder live dictationspeakwith://live-dictation/start
Stop a takestop recording recorder live dictationspeakwith://live-dictation/stop
Set standby on / offset standby recorder live dictation enabled true (or false)speakwith://live-dictation/standby?on=true (or false)

Each AppleScript command runs inside tell application "SpeakWith" to … — for example, osascript -e 'tell application "SpeakWith" to power off recorder batch'.

A few things worth knowing: every command is safe to repeat — running “start” while already recording, or “power on” while already on, simply does nothing. Standby only affects the recorder that is currently powered on; it never powers a recorder on by itself.

Targeting a specific build

By default these commands find SpeakWith by name. If you have more than one SpeakWith build installed, pin the exact one you want by its bundle identifier:

osascript -e 'tell application id "com.ikisystems.speakwith.macos.gumroad" to start recording recorder live dictation'

The shipping bundle identifiers are com.ikisystems.speakwith.macos.gumroad (Gumroad), com.ikisystems.speakwith.macos.appstore (Mac App Store), and com.ikisystems.speakwith.macos (Developer ID direct download).

Wire it to a hotkey

Because these are ordinary commands and URLs, you can turn any of them into a keyboard shortcut today. Drop one into a macOS Shortcut, an Automator “Run Shell Script” action, or a launcher such as Raycast, Alfred, or Keyboard Maestro, and give it the hotkey you like.