ognistik/macrowhisper v1.2.0

on GitHub

Changed

• All action types now support icons.

• Any action can be set as default—activeInsert has been replaced with activeAction.

• The restoreClipboard setting can now be configured at the action level.

• Improved clipboard restoration and syncing with Superwhisper's result:

  • This enhancement reduces conflicts with Superwhisper's recording window animation and clipboard usage.
  • Most users can now set actionDelay to 0 for better performance. If you encounter issues (e.g., the recording window not closing, app pasting previous clipboard), you can still adjust this setting.

• The --exec-action flag now works correctly for all action types. You can run any action using the last Superwhisper result directly from the command line.

  • I am finding this a very convenient way to trigger scripts/shortcuts using Superwhisper results, but triggered externally from Keyboard Maestro/Karabiner/BTT.

• Improved trigger logic for "and" conditions:

  • Fixed a bug where empty triggers in "and" logic matched everything. Now both "and" and "or" logic ignore empty triggers and only use those with values.

• The new unified --remove-action <name> CLI command works with any action type (insert, URL, shortcut, shell, AppleScript).

• CLI commands now use consistent "action" terminology:

  • --get-action [<name>] replaces --get-insert [<name>]
  • --action [<name>] replaces --insert [<name>]
  • --remove-action <name> replaces all individual --remove-insert, --remove-url, etc.
  • New --list-actions command shows all actions in the configuration file.

• Improved --auto-return <true/false>:

  • If a recording is cancelled, auto-return (designed for single interactions) will now turn itself off automatically.

• Fixed date placeholders like {{date:yyyy-MM-dd}}. Macrowhisper previously converted UTS 35 patterns to localized formats—now it follows your template exactly.

• Added special escaping template for JSON. This is particularly useful for Shortcut actions. To build dictionaries with placeholders, add the json: prefix to any existing placeholder for proper escaping:

  • Simple Shortcut Action with Dictionary: "action" : "{\"theResult\": \"{{json:swResult}}\"}"
  • A more complex example is included in the sample config.
  • A simpler approach to using dictionaries without dealing with escaping is creating a Superwhisper mode to give you the result in JSON. Then you just send {{swResult}} to a Shortcut, which will parse it correctly

• Introduced a raw: prefix for placeholders, which strips any escaping added by default. Use this prefix if you need your placeholder output to remain untouched for a given action (this is the default for Shortcuts or Insert actions).

  • For example, with this, you can now instruct a Superwhisper mode to write AppleScript for you, then send it right to execution—letting you control your Mac with plain voice instructions. Be cautious if you do this, it's powerful stuff.

• The values of {{duration}}, {{processingTime}}, and {{languageModelProcessingTime}} are now dynmically converted to seconds or minutes when used in actions for better readability.

• Expanded the regex engine's capability to handle newlines in placeholders.

• Improved logic for regex replacements and removal of empty meta.json key placeholders:

  • If a placeholder is used in an action but found empty in the meta.json file, it will simply be removed.

The new CLI commands and config changes are backward compatible, so updating your config file isn't required—nothing will break. However, sample Keyboard Maestro macros and documentation have been updated for the new flags. If you want to refresh your config quickly, add an action via the CLI (for example: --add-insert AnyName). This will add icon and restoreClipboard properties to all actions and convert activeInsert to activeAction. If you decide to update your config, it is suggested you make a backup first—just to be safe.

How to Update

If Installed through Homebrew

brew update
brew upgrade macrowhisper
macrowhisper --restart-service

If Installed with Script

curl -L https://raw.githubusercontent.com/ognistik/macrowhisper/main/scripts/install.sh | sh
macrowhisper --restart-service

You may need to grant accessibility permissions one more time