ZapPad for Mac · Focused help guide

Create and replay macros

ZapPad macros turn supported, reviewed text operations into repeatable local steps. Teach a cleanup from examples, record supported editing commands, or save a generated transformation, then inspect and replay the macro.

See the complete ZapPad manual for all menus, settings and troubleshooting. These focused guides are drawn from the same current manual.

Applies to the current Direct release documentation for Apple Silicon Macs on macOS 12 or later.

How to use this feature

Describe a change

  1. Select text, or select nothing to work on the whole pad.
  2. Type an instruction in the description bar, e.g. trim whitespace, remove duplicate lines, then sort lines or keep lines starting with WARN.
  3. Click Preview, press Return in the field, or choose Intelligence›Preview Described Change (⌘↩).
  4. ZapPad turns the instruction into specific commands, runs them locally and opens the Review Changes window. Check the commands and the result, then Apply or Save Macro.

Show or hide the bar with View›Show Description Bar.

Teach with examples

Tools›Examples and Snippets›Teach Macro with Examples… takes two before/after pairs. ZapPad looks for a single exact rule that produces both - trim, sort, deduplicate, case conversion, removing blank lines, or two-step combinations of these - and shows it in the review window. If no rule fits, or several fit, it explains and changes nothing. No AI is used.

Recording a macro

  1. Choose Macros›Start Recording (⇧⌘R). The status confirms recording.
  2. Edit with the keyboard: typing, deleting, keyboard navigation, Find Next, inserts and applied tool previews are recorded.
  3. Choose Macros›Stop Recording… (⇧⌘R) and name the macro.
Actions that stop recording

Mouse clicks in the editor, column selections, Undo/Redo, switching pads, Find All and Replace All, split or cloned views, navigation commands, image imports and column fill can’t be replayed portably. ZapPad stops recording and tells you why in the status line.

Running a macro

  • Choose it from the Macros menu, the toolbar’s Run Macro, or its shortcut ⌥⌘ + the letter or digit you assigned.
  • Enter a repeat count from 1 to 1,000, or end to repeat to the end of the pad.
  • The result opens in the review window. Replay never uses AI.
  • Highlighting must be a macro’s last step, and highlight macros run once.

Managing macros

Macros›Manage Macros… - choose a macro, then:

Save ChangesSaves the edited name and shortcut (one letter or digit, used with ⌥⌘; leave empty for none). Duplicate shortcuts are rejected.
ExportSaves the macro as a .zappadmacro file.
DeleteDeletes the macro immediately (there is no separate confirmation).
Inspect StepsLists every step with its arguments.
Version History…Restores an earlier saved version of the macro (up to 100 kept). Restoring doesn’t run it.

Macros›Import Macro… adds a .zappadmacro (or older JSON macro) file up to 2 MB; it’s validated and gets a new identity.

Frequently asked questions

Can ZapPad automate the same text cleanup every week?

Yes. Save supported steps as a macro and replay them on later text. Macro replay is local and does not call an AI model. Review the result before applying it, and keep a recovery path for important files.

Can every mouse or editing action be recorded?

No. Recording covers supported keyboard edits and applied previews. Mouse clicks in the editor, Undo/Redo, switching pads, column selections, Find All and Replace All, and several navigation or view commands stop recording because they cannot be replayed portably.

Does teaching a macro use AI?

No. Teach Macro with Examples looks for an exact supported rule that fits both before-and-after examples. If no unique supported rule fits, ZapPad explains why and changes nothing. Described changes and regex generation are separate optional features.

For complete current feature details, open the ZapPad manual.