URL scheme¶

The dictate:// URL scheme lets automation tools control recording and open local views.

Registration

macOS registers custom URL schemes from a packaged .app bundle. In v0.1 development, invoke the handler directly with python3 -m dictate "dictate://toggle".

Supported URLs¶

open "dictate://record"
open "dictate://stop"
open "dictate://toggle"
open "dictate://history"
open "dictate://settings"

Hammerspoon¶

hs.hotkey.bind({"cmd", "alt"}, "D", function()
  hs.execute('open "dictate://toggle"')
end)

During development:

hs.execute('cd ~/dictate && python3 -m dictate "dictate://toggle"')

Keyboard Maestro¶

Create a macro with an Execute Shell Script action:

open "dictate://record"

Add a second macro for stop:

open "dictate://stop"

Shortcuts.app¶

Create a new shortcut.
Add Open URLs.
Use dictate://toggle or dictate://history as the URL.
Assign a keyboard shortcut or Siri phrase.

For development, use Run Shell Script instead:

cd ~/dictate
python3 -m dictate "dictate://toggle"