ZapPad for Mac · User manual

Everything ZapPad does, menu by menu.

ZapPad is a native text workbench for macOS: capture text instantly, edit and search precisely, transform data with reviewed previews, replay macros, and inspect Markdown and structured data. This guide explains every menu item, button and setting, when each one appears, and what your plan includes.

Updated for ZapPad Direct 1.1.0, macOS 12 or later on Apple Silicon. Menu names appear in bold.

Focused how-to guides

Find the ZapPad instructions you need.

Search large log files

Learn how ZapPad opens large UTF-8 logs in a read-only, bounded-memory viewer, searches literal text, follows new lines, and explains its file-size limits.

Open guide →
Create and replay macros

Learn to describe, teach, record, inspect and replay supported ZapPad macros locally, with limits on recorded commands and a preview before applying changes.

Open guide →
Use PCRE2 regex

Use PCRE2 search, capture-aware replacements, line extraction and review previews in ZapPad, and understand how ordinary regex differs from large-log literal search.

Open guide →
Clean CSV and JSON

Use ZapPad’s structured-data tools for CSV, TSV and JSON, preserve text identifiers and numeric precision, and review conversions before applying them.

Open guide →
Save and recover text

Understand ZapPad’s local drafts, named-file saves, recoverable archives, revisions, conflict checks and limits of interrupted batch recovery.

Open guide →
Choose text encoding

Identify UTF-8 and legacy text encodings in ZapPad, select an explicit interpretation when needed, and keep the original unchanged until you choose to save.

Open guide →
Preview Markdown

Open ZapPad’s local Markdown preview, inspect rendered headings, lists, links and code, and understand what the preview does not export or alter.

Open guide →
Use Quick Capture

Open ZapPad’s floating Quick Capture panel, change its shortcut, use the menu bar helper and understand what happens when the panel closes.

Open guide →
Keyboard shortcuts

Find ZapPad keyboard shortcuts for capture, editing, search, macros, navigation and windows, with notes on configurable shortcuts and limited recording support.

Open guide →
Trial, plans and billing

Understand ZapPad’s automatic 14-day Direct trial, US Annual and Monthly prices, cancellation, paid coverage, activation limits and covered-build rules.

Open guide →

Getting started

What you need, what happens at first launch, and how the ZapPad window is organized.

Requirements

  • An Apple Silicon Mac (M1 or later) running macOS 12 or later. Intel Macs cannot run this build. Check compatibility before buying; a browser checkout does not prove that the app can run on your computer.
  • A valid Direct license or the automatic fourteen-day trial for this Mac. Initial trial issuance or license activation requires internet. No ZapPad account is required.
  • For described changes (the Intelligence menu and description bar): Apple Intelligence enabled in System Settings with its on-device model downloaded. Every other tool works without it.

First launch

  1. On first launch, Welcome to ZapPad explains the trial and licensing connections before the request. Choose Continue to proceed, Privacy Policy to read the notice, or Quit to stop before the request. This is not an email signup or a purchase.
  2. The Direct build requests an automatic fourteen-day trial. The main window shows remaining days and Buy ZapPad. If trial issuance fails, use the retry control and check the connection; if no access applies, the activation screen appears.
  3. Once access is active, the full editor opens with an empty pad. The status line suggests: paste a list, then describe a change above, and review before applying.
  4. To try a guided example, choose Help›Open Cleanup Example. It creates a “Cleanup Demo” pad with sample email addresses and fills the description bar with “Trim whitespace, remove duplicate lines, then sort lines”. Choose Preview, inspect the result, then apply it or save it as a macro.

A tour of the window

The full editor window is arranged from top to bottom:

The toolbar

ZapPad toolbar: New, Open, Save, Undo, Redo, Run Macro, Files, Split View and Settings. ZapPad compact toolbar in dark appearance.
The streamlined full-editor toolbar uses locally bundled Lucide icons. Stop appears only while a background task is running.
ButtonWhat it does
NewCreates a new, empty pad.
OpenOpens one or more files from disk.
SaveSaves the pad to its file. An unnamed pad asks for a file name and location.
Undo / RedoReverses or reapplies an edit. Disabled when unavailable.
Run MacroShows saved macros in a pop-up menu for replay.
FilesShows or hides the authorized-folder File Browser.
Split ViewShows or hides a second view of the same pad.
SettingsOpens Settings.
ExpandAppears in Quick Capture and switches to the full editor.
StopAppears while a task runs. Cancels the task before changes are applied.

Search stays in the bottom Find bar. The adjacent Find and Replace… button opens the replacement sheet (also ⌘F). Macro management remains in Macros; table conversions are under Actions › Data › Table Tools…; Comment and Remove Line Comments remain in the Code actions and menus. Show or hide the description bar through View › Show Description Bar. These secondary actions no longer duplicate the top toolbar.

Pad tabs

Each open pad has a tab. Click a tab to switch; ZapPad saves the current pad first. The × on a tab closes and archives that pad (recoverable for 30 days). The buttons at the right of the tab strip are Scroll tabs leftScroll tabs rightAll Tabs (a menu of every open pad, with the current one checked) and New pad. Pinned pads show a • before their name.

The bottom bar keeps Find, Find next and Find and Replace… together. Input borders and panel dividers adapt to light/dark appearance and Increase Contrast.

ControlWhat it does
Find field and ⌄ buttonQuick search in the current pad. Press Return or the arrow to select the next match. See Inline find.
Match Case · Whole Words · RegexOptions for the footer find field.
MD Preview / Markdown?Appears for Markdown pads (MD Preview) or text that looks like Markdown (Markdown?). Opens Markdown Preview.
Position readoutShows Ln · Col · Pos (line, column, one-based UTF-16 position). With a selection it adds the selected range, its length in UTF-16 units and the anchor; for column selections it shows the row count, and for multiple cursors the cursor count.
Syntax languageChooses the pad’s language for coloring and tools. See Languages.
File encodingUTF-8, UTF-8 BOM, UTF-16 LE, UTF-16 BE, ISO-8859-1, Mac Roman, Shift-JIS or Windows-1252. See Encoding and line endings.
Line endingsLF, CRLF or CR. Changing it converts every line ending in the pad (undoable).

Quick Capture panel vs. full editor

Capture means opening a quick note window for typing or pasting text. It does not take a screenshot or record the screen. The global shortcut requires ZapPad or its capture helper to be running; closing the editor window keeps the app running, while Quit stops it. Keep capture available at login starts the helper at login. Control–Option–Space is the default unless VoiceOver requires Control–Shift–Space or you choose another shortcut in Settings.

ZapPad has two surfaces that share the same pads:

  • Quick Capture: a small floating panel for jotting or pasting. It shows a recent-pads menu, the pad title, and the New, Save and Expand buttons. It stays above other windows and on every Space. Press Esc to dismiss it and return to the app you were using.
  • Full editor: the complete window with tabs, inspector, footer and the streamlined toolbar. Open it with View›Full Editor (⇧⌘E) or Expand.

Closing the window (the red button) saves and hides ZapPad rather than quitting. ZapPad keeps running so capture stays instant; choose ZapPad›Quit ZapPad to quit.

How saving works

ZapPad keeps two kinds of saving separate:

  • Saved locally - every edit is committed to ZapPad’s private database on your Mac within a fraction of a second. The status line shows Saving locally… then Saved locally · N characters. Unnamed pads live only here.
  • File saved - named files are written to disk only when you choose Save, Save As… or Save All. After a save the status reads File saved · Recovery copy saved locally.

Until a pad has a file name, its title comes from its first line (up to 48 characters) unless you rename it.

Direct licenses and trial

This guide describes the Direct download build. The Mac App Store release is paused and has separate purchasing controls.

Annual or Monthly license

PlanUS priceCoverage
Annual license$29.99/year until canceledTwelve calendar months of updates per confirmed paid annual period.
Monthly license$2.99/month; $35.88 total over twelve paid monthsRenews monthly until canceled. Twelve confirmed paid months qualify for completed-year access.

Both schedules provide the same Pro features and allow up to three activated Macs per key. Checkout shows the applicable total and currency. An Annual payment does not start automatic annual billing.

Automatic fourteen-day trial

The Direct trial starts when the service successfully issues it for this Mac. Initial internet access is required; no email signup or card is needed. The signed trial then works offline until expiry. A reinstall on a recognized Mac returns the original expiry; a different Mac has its own trial. Trial time does not count toward paid coverage. An online refresh may return a revocation.

The main window shows ZapPad Trial, remaining days and Buy ZapPad. A trial never converts to a paid purchase automatically.

The Pro purchase screen

Click Buy ZapPad or open ZapPad › ZapPad Pro…. Choose a payment schedule in the checkout, then enter the supplied key in the license screen and activate it.

  • Refresh License: validate the saved key and refresh confirmed coverage.
  • Manage Billing: open Lemon Squeezy billing management. Cancel billing here; quitting, uninstalling or deactivating does not cancel charges.
  • Find My License Key: recover purchases through Lemon Squeezy using the purchase email. Keep that email accessible.
  • Deactivate This Mac: stop the license activation here. After server confirmation, the slot can be used on another Mac. The key and history stay in Keychain for Reactivate This Mac; this is not data deletion. An uncertain response can require Retry Deactivation.
  • Activation on another Mac needs internet and service-confirmed coverage. Local cached evidence is not automatically transferred between Macs.
  • Privacy Policy and Terms of Use: read the complete disclosures.

In Apple-distributed builds, Restore Purchases, Manage Subscription and Try Again refer to Apple purchases. They do not restore Direct keys. The App Store release is paused; do not use this guide as an offer of an unshipped Apple plan.

Renewal and cancellation

Cancel Monthly at any time to stop future charges. No remaining balance or installments are owed. If you cancel before twelve distinct confirmed paid months, access ends with the current paid month. Completing twelve confirmed paid months qualifies for the completed-year coverage below. Unobserved or unconfirmed periods do not count.

Covered builds and updates

An Annual license retains access to builds released on or before the end of its paid year. After twelve confirmed Monthly periods, the completed-year cutoff is frozen at the confirmed end of month twelve. Covered builds remain usable after payments stop; later builds require additional coverage. This is not all future releases. A disabled or refunded key revokes affected license access, including fallback. Future macOS compatibility is not guaranteed.

When access expires

If neither a trial nor paid coverage applies to this build, editing and Pro tools lock. Documents and drafts remain preserved. Activate valid coverage or use an entitled build. Purchase controls, legal links and Quit remain available.

Using Pro offline

The trial works through its signed expiry. Paid access uses the last confirmed coverage in Keychain. Initial trial issuance, activation, fresh coverage confirmation and billing management need internet. Online validation may revoke access. The Direct updater checks update eligibility against release dates.

Annual subscriptions renew at $29.99 USD/year and Monthly subscriptions at $2.99 USD/month ($35.88 over twelve paid months), until canceled. We will notify you before any renewal price increase and obtain any consent required by applicable law. To disable automatic billing, open Manage Billing / Cancel Renewal, sign in with your purchase email, select your subscription and cancel before its renewal date. Cancellation stops future charges; the current paid period and earned covered-build rights remain available under these terms. Deactivating a Mac or deleting ZapPad does not cancel billing. We do not provide prorated refunds for unused time or partial billing periods, except where required by law or Lemon Squeezy's applicable policies. Existing one-time purchases remain one-time and are not automatically enrolled into a subscription. The card-free app trial never starts billing.

Quick capture

Summon a pad from anywhere, paste or type, and dismiss it without losing anything.

The capture shortcut

  • Press ⌃⌥Space (Control–Option–Space) to open the Quick Capture panel from any app. When VoiceOver is running, the default is ⌃⇧Space.
  • Change it in Settings › Capture. If the shortcut can’t be registered (for example, another app uses it), the status line explains why.
  • Optional: Double-tap Option to capture in Settings. macOS asks you to allow Input Monitoring for this gesture; the regular shortcut still works without it.
  • Press Esc in the panel, or choose File›Dismiss Capture, to save, hide ZapPad and return to the app you were using.

Capture when ZapPad isn’t running

Turn on Keep capture available at login in Settings to install a small resident helper. It owns the capture shortcut while the editor isn’t running and launches ZapPad when you press it. Its menu bar menu has Capture in ZapPad, Settings… and Quit ZapPad Capture. Quitting ZapPad also stops the helper; it starts again at your next login.

Daily pad

With Use a daily pad for new captures turned on in Settings, each capture opens a pad titled with today’s date, creating it the first time each day.

Pads, files and recovery

A pad is a ZapPad document. It may be unnamed (stored only in ZapPad) or linked to a file on disk.

The File menu

ItemWhat it does
New Pad ⌘NCreates an empty, unnamed pad and switches to it.
Open… ⌘OOpens one or more files. You can also drag files from Finder onto the editor to open them. A file that’s already open switches to its existing tab. Files keep their original location.
Save ⌘SWrites the pad to its file. An unnamed pad asks for a name; ZapPad suggests one from the title and language. ZapPad may ask for access to the containing folder so it can replace the file safely.
Save As… ⇧⌘SSaves to a new file name or location; the pad then points to the new file.
Save AllSaves every pad that has a file. Unnamed pads stay saved locally.
Reload from Disk…For pads with a file. Replaces the text with the file’s current contents after confirmation. The text you had stays in Version History.
Rename Pad…Changes the pad’s title in ZapPad. It doesn’t rename the file - use Save As for that.
Pin / Unpin PadPins the pad (a checkmark shows when pinned). Pinned pads show • in tabs and 📌 in lists.
Close and Archive Pad ⌘WCloses the pad and moves it to the archive, where it stays recoverable for 30 days. Files on disk are untouched. When another ZapPad window (for example a preview) is in front, this item reads Close Window and closes that window instead.
Reopen Last Closed Pad ⇧⌘TRestores the most recently archived pad.
Version History…Lists earlier saved revisions of this pad. Choose one and Preview to see it next to the current text in the review window; Apply Changes restores it (undoable).
Back Up Pads…Saves a complete copy of ZapPad’s local database (pads, history and macros) to a .sqlite file you choose.
Import Backup…Adds the pads and macros from a backup file under new identities. Your existing pads are kept; nothing is overwritten.
Archive All Pads…After confirmation, archives every open pad and starts a fresh empty pad. Archived pads remain recoverable for 30 days; files on disk are kept.
Delete Archived Pads…Permanent. After a warning, deletes all archived pads and their history. This can’t be undone; back up first if needed. Files on disk are kept.
Dismiss CaptureSaves, hides ZapPad’s windows and returns to the previous app.

Library and pad search

Choose View›Show Library and Pad Search (⇧⌘L) to show a sidebar listing all pads (pinned first, with modification dates). Type in Find your scraps to search pad titles and contents:

  • Each word is matched as a prefix, and all words must match (e.g. invoice 007).
  • Enter plain words - not regex, SQL or wildcards.
  • If Index pads for semantic search and Spotlight is on in Settings, related results can appear after the immediate text matches.
  • Click a result to open that pad.

In the Quick Capture panel, the menu at the top lists recent pads instead.

Archive and recovery

  • Closing a pad archives it. Archived pads are kept for 30 days, then removed automatically when ZapPad starts.
  • File›Reopen Last Closed Pad brings back the most recent one.
  • Each pad keeps up to 100 recent revisions in Version History.
  • Annotations - colored marks and bookmarks - are stored with the pad in ZapPad, not written into your file.

Encoding and line endings

  • Use the footer’s File encoding menu to choose how the pad is written when saved. If the text contains characters the chosen encoding can’t represent, ZapPad shows an error and keeps the previous encoding.
  • To read a file in a legacy encoding, use Tools›Files and Folders›Open with Legacy Encoding… and enter Windows-1252, ISO-8859-1, Mac Roman or Shift-JIS. Only exact round trips are accepted; check the text before saving.
  • The footer’s Line endings menu (LF, CRLF, CR) converts the whole pad. Undo reverses it.

When a file changes on disk

When you switch back to ZapPad, it checks whether the current pad’s file was changed by another app. If so, the status line reads Changed on disk. Reload or Save As to preserve both versions. If ZapPad can no longer access the file, it reads File access unavailable. Your recovery copy is safe; reopen the file to grant access.

Editing

Standard editing plus column selection, multiple cursors, special paste and inserts.

The Edit menu

ItemWhat it does
Undo ⌘Z · Redo ⇧⌘ZUndo or redo edits. An applied preview counts as one edit. Disabled while the pad is read-only.
Cut · Copy · Paste · Select AllStandard commands (⌘X ⌘C ⌘V ⌘A).
Selection and Columns ›See Selection and columns.
Clipboard and Characters ›See Clipboard and characters.
Insert ›Date and Time (local medium format), ISO 8601 Timestamp or UUID, replacing the selection.

Column selection and multiple cursors

  • Option-drag, or hold OptionShift and press arrow keys, to select a rectangular block.
  • View›Column Selection (⌥⇧⌘B) toggles rectangular selection mode.
  • Typing replaces the same columns on every selected row. The footer shows Column · N rows.
  • Column selection is positional. For quoted or variable-width CSV fields, use the table tools instead.

Selection and Columns submenu

ItemWhat it does
Begin / End SelectionChoose once to mark a start point, move the cursor, then choose again to select everything between.
Begin / End Column SelectionThe same, but the result is a rectangular (column) selection.
Fill Column with Text / Numbers…For each cursor or selected row, top to bottom, inserts the same text (mode text) or an increasing number (mode numbers, with a starting integer and increment). Not available while recording a macro.
Select Next OccurrenceAdds the next occurrence of the selected text as another selection. Occurrence matching is case-sensitive.
Select All OccurrencesSelects every occurrence at once.
Undo Latest SelectionRemoves the most recently added selection.
Skip Current OccurrenceSkips the current occurrence and moves to the next one.

Clipboard and Characters submenu

ItemWhat it does
Paste Plain TextPastes the clipboard as plain text.
Paste with LF Line EndingsConverts CRLF/CR to LF while pasting.
Paste Decoded JSON StringDecodes a JSON string literal on the clipboard (e.g. "a\nb") and pastes the result.
Capture Clipboard While ZapPad Is ActiveOptional. While on (checkmark), ZapPad remembers plain text you copy while ZapPad is the active app: up to 20 entries of 64 KiB each, for this session only. Choose again to stop.
Clipboard History…Pick an entry and choose Copy Entry, or Clear History. Pasting is always your choice.
Characters and Symbols…Opens the macOS Character Viewer.

Pastes larger than 16 MiB are refused.

Select quotes and surround text

Search › Navigate and Select › Select Inside Quotes selects text inside single, double, or backtick quotes on the current line. Place the caret inside the quoted content. Escaped quotes and word apostrophes are handled; this is a text helper, not a language parser.

Tools › Surround Selection wraps text in parentheses, brackets, braces, quotes, backticks, or a named tag. With no selection, it inserts the pair and places the caret inside. Selected contents are preserved without automatic escaping. One Undo restores the original text. Use one ordinary selection.

Tools and transformations

Most tools act on the current selection, or on the whole pad when nothing is selected, and show a preview before changing anything.

The Review Changes window

Transformations, described changes, macro replays, Replace All, version restores and snippets open a Review Changes sheet:

  • A summary and the exact commands that will run (with their patterns and replacements).
  • Counts: lines before → after · characters before → afteror for highlight macros, N matches to highlight.
  • Original and Result columns, read-only, with changes highlighted. Click the lock between them to synchronize scrolling in either direction; click again to scroll independently. Synchronization follows relative position when the two texts have different lengths.
  • Cancel (Esc), closes without changing anything.
  • Save Macro…: saves the commands as a reusable macro (only when the preview has commands).
  • Apply Changes (↩), replaces the text as one undoable edit. It reads Apply Highlights for highlight-only macros, and is disabled when nothing would change.
If the pad changed meanwhile

Applying is refused with The document changed. Generate a new preview before applying. Run the tool again. Previews also can’t be applied while the pad is read-only.

Text submenu

ItemWhat it does
Trim Whitespace…Removes leading and trailing whitespace on each line.
Sort Lines…Sorts lines in ascending order.
Remove Duplicate Lines…Keeps the first occurrence of each line.
UPPERCASE… · lowercase…Changes case.
Keep Matching Lines…Asks for a PCRE2 pattern and keeps only lines that match.
Delete Matching Lines…Removes lines that match a pattern.
Extract Matches…Replaces the text with just the matches of a pattern.
Replace with Regex…Asks for a pattern and replacement together ($1, ${name}).
Replace Text…Literal find and replace; symbols such as *, $1 and backslashes are not interpreted.
Split into Lines…Splits at a literal separator (required).
Join Lines…Joins lines with a literal separator (empty uses one space).
Format JSON…Re-indents valid JSON. Numbers, key order and strings are preserved.
Clean Up Escaped JSON…Decodes JSON that’s wrapped in string quotes (up to 8 layers) and formats it. See JSON tools.
Format SQL…Asks for a dialect - sql, postgresql, mysql, sqlite or tsql - and reformats layout. It never runs SQL.
Indent… · Unindent…Shifts lines by the indent width.
Remove Blank Lines…Deletes empty lines.
Toggle Line Comment…Uses the active syntax language’s line marker. HTML and CSS use safe block wrappers; lines containing a conflicting closing delimiter are rejected without changes.
Compare with File…Opens a comparison window between this pad and a file.
Compare Two Open Tabs…Choose a left and right pad (unsaved pads included) and compare them read-only.

Whole-pad Format JSON, Clean Up Escaped JSON and Format SQL also switch the pad’s language to JSON or SQL. Plain text and JSON have no assumed comment syntax, so choose a supported language before using Comment or Uncomment.

Tables submenu

ItemWhat it does
Extract CSV Columns…Keeps the columns you list as a JSON array of zero-based indexes, e.g. [0,2]. Columns can be reordered or repeated. Rows missing a column are rejected.
Filter CSV Rows…Keeps rows where a zero-based column equals or contains a literal value (case-sensitive). A header row is treated as data.
Group CSV Rows…Groups rows by a zero-based column into a JSON object.
JSON5 Subset to JSON…Converts a supported subset of JSON5 to strict JSON.
Python Literal Subset to JSON…Converts supported Python literals (dicts, lists, strings, numbers) to JSON.
CSV to TSV… · TSV to CSV…Converts delimiters, quoting as needed.
CSV to JSON Rows…Converts rows to a JSON array of string arrays.
JSON String Rows to CSV…Converts a JSON array of string rows to CSV.

All values are kept as strings, so IDs with leading zeros survive. Actions › Data › Table Tools… offers the conversions that fit the current text.

Pasted data detection

When you paste up to 256 KiB of JSON, CSV or TSV, ZapPad checks it in the background without changing it. A button such as JSON Detected - Tools… appears above the editor, offering Preview JSON Cleanup…, Preview CSV to JSON… or Preview TSV to CSV…. For JSON, the status line also says whether the syntax is valid or string-wrapped. Turn off View›Detect Pasted Code to stop automatic language detection on paste.

Code submenu

ItemWhat it does
Check JSON Syntax…Validates the selection or pad and reports in the status line (JSON syntax is valid. Text unchanged.) or shows the error with line and column.
Parameter Hints…Shows declarations in this pad that match the function at the cursor. Local text matching - not compiler or language-server analysis.
Complete Relative Path…Choose a folder you authorize and a relative prefix; pick a matching path to insert. Parent traversal and symbolic links are excluded.
Automatic PairingToggles automatic closing of brackets and quotes.
Custom Language Profile…Create a profile with a unique name, a bundled lexer (e.g. cpp, python, sql), extra keywords (up to 16 KiB) and an indent width of 1–8. It appears in the language picker. Up to 100 profiles.
Function / Heading Outline…Shows a menu of functions or headings in the pad; choose one to jump to it.
Complete WordSuggests completions from words already in the pad.

Advanced Views submenu

Document MapShows a narrow overview strip beside the editor; click it to jump to that line.
Split / Unsplit EditorA second, synchronized view of the same pad.
Clone Active Pad in WindowOpens the pad in a separate window that edits the same text.
Synchronize Cloned ScrollingKeeps vertical scrolling aligned between views.
Virtual SpaceLets the cursor move past the end of a line.
Overwrite ModeTyping replaces characters instead of inserting.
Hide Selected Lines · Show All LinesTemporarily hides lines from view, and shows them again.

Close split and cloned views before recording a macro.

View Sessions submenu

Save View Session… stores a named layout: tab order, the active pad, selection, scroll position and whether the editor is split. Restore View Session… brings one back. Text itself stays in normal pad storage, and restoring never archives other pads.

Files and Folders submenu

Open with Legacy Encoding…See Encoding.
Text Statistics / Unicode / SHA-256…Shows UTF-8 bytes, UTF-16 positions, characters, lines, the SHA-256 of the UTF-8 text, and the first 64 Unicode code points, for the selection or pad. Copy copies the report.
Reveal File in FinderShows the pad’s file in Finder (named files only).
Print…Prints the pad as plain monospaced text.
Search / Replace in Folder…See Folder search and replace.
Open Large File Read-Only…See Large-file viewer.

Large-file viewer

Tools›Files and Folders›Open Large File Read-Only… opens very large files (multi-gigabyte logs included) in a separate read-only window. It never rewrites the file.

  • Previous / Next move through 256 KiB pages; the status shows the byte range.
  • Search finds case-sensitive literal text across the whole file and lists up to 1,000 byte-offset results. Cancel stops it.
  • Filter visible lines (press Return) shows only matching lines on the current page. Save Filter remembers it for the next viewer.
  • Follow Tail refreshes the last page once per second, like tail -f. Searching or paging stops following.
  • WARN and ERROR lines are highlighted. A page boundary may split a character; the replacement glyph is display-only.

Comparison window

Opened by Compare with File… or Compare Two Open Tabs…. It is read-only and changes neither side.

  • Side by Side or Unified Diff view.
  • Ignore whitespace, Ignore case and Ignore line endings options.
  • Previous Change / Next Change navigation and Copy Unified Diff.

Examples and Snippets submenu

Teach Macro with Examples… - see Teach with examples.

Insert Snippet / Template… inserts text built from a template with {{name}} placeholders:

  • Saved name - load a saved template, or enter a new name to save this one.
  • Template - e.g. {{title}} - {{timestamp}}. {{timestamp}} is filled automatically.
  • Values as JSON strings - e.g. {"title":"Incident 007"}. Every placeholder needs a value.

The result is shown in the review window before insertion. Templates are literal text - no code runs.

Calculate and Compare submenu

Calculate…Evaluates arithmetic with + - * /, parentheses and scientific notation, e.g. 1.5e3 / (2 + 3). Uses standard floating-point arithmetic (not financial decimal). Copy copies the answer.
Convert Units…Case-sensitive units: length m km cm mm in ft mi; mass kg g lb; time s min h; data B KB MB KiB MiB GiB; temperature K C F. Offline.
Compare JSON Ignoring Key Order…Compares the selection or pad with a JSON file. If equivalent, says so. If not, the review window shows the file’s text; Apply Changes would replace your selection with it, so choose Cancel unless that’s what you want.
Compare CSV by Key Column…Matches rows by a unique zero-based key column and lists up to the first 50 changed keys.

Conversions and Text Utilities submenu

Conversion Workbench… opens a separate window with the selection or pad as input: choose a conversion, Preview Conversion, then Copy Result (or Stop). The source pad is never changed. The other items run through the review window:

Base64 ›Base64 Encode (Padded)… · Base64 Encode (Unpadded)… · Base64 Encode - MIME / Unix EOL… · Base64 Encode Each Line… · Base64 Decode (Whitespace Tolerant)… · Base64 Decode - Strict… · Base64 Decode Each Line…
Web and MIME ›Quoted-Printable Encode… · Quoted-Printable Decode… · URL Encode - Component… · URL Encode - RFC 1738… · URL Encode - RFC 1738 Each Line… · URL Encode - Extended Component… · URL Encode - Extended Each Line… · URL Encode - Every UTF-8 Byte… · URL Encode - Every Byte Each Line… · URL Encode Each Line… · URL Decode… · Decode SAML Request / Response… (decoding only; signatures are not verified)
Conversion ›Text → Hex (UTF-8)… · Hex → Text (UTF-8)… · Escape as JSON String… · Decode JSON String…
Case, Lines and Whitespace ›Title Case… · Sentence Case… · Invert Case… · Trim Leading Whitespace… · Trim Trailing Whitespace… · Tabs → Spaces (Tab Stops of 4)… · Leading Spaces → Tabs (Width 4)… · Reverse Line Order… · Sort Lines Descending… · Duplicate Lines… · Remove Empty Lines (Keep Whitespace-Only)… · Join Lines Without Separator…

Checksums submenu

For each of MD5, SHA-1, SHA-256 and SHA-512: Generate from Selection / Pad…, Generate from Files… (one or more files) and Copy Selection / Pad Checksum. Results appear in a window with Copy Result. MD5 and SHA-1 are legacy checksums, not for security.

Syntax-Colored Export submenu

Export HTML…, Export RTF…, Copy HTML, Copy RTF and Copy All Formats export the selection or pad with its syntax colors - handy for documents and slides. Up to 2 MiB per export. The pad isn’t changed.

Bundled Tool Packs…

Show or hide the Conversions and Text Utilities, Checksums and Syntax-Colored Export groups in the Tools menu. These are built in; no plug-ins or scripts are downloaded.

Data Inspection

Tools › Data Inspection contains the following native tools. Inspectors read a snapshot of the selection, or the whole pad if nothing is selected. Reopen an inspector after editing the source.

  • JSON Inspector…: expand objects and arrays, select nodes to locate their exact source range, and use Copy Path / Copy Value. Numeric source tokens are preserved. Run Query supports RFC 6901 JSON Pointer (/users/0/name) and JSONPath property/index paths with wildcards ($.users[*].name), not filter expressions.
  • Check JSON Schema…: choose a local JSON schema. Supported assertions include types, properties, required fields, additionalProperties, items, enum/const, string lengths and patterns, item counts, numeric bounds, allOf/anyOf/oneOf/not, and local #/… references. This is an explicit subset, not complete draft conformance. Unsupported assertions produce an error. Patterns use bounded PCRE2; numeric schema literals are limited to 15 digits and numeric comparisons to Decimal range/precision. No remote schema is fetched.
  • Delimited Data Check…: detect comma, tab, semicolon or pipe separators, or choose one explicitly. Quoted commas, escaped quotes and multiline fields are parsed. The grid marks invalid records/fields in red; diagnostics use logical record numbers. Up to 100 columns are displayed.
  • Infer SchemaLoad Schema… and Save Schema…: edit reusable column rules as JSON, for example [{"name":"id","type":"string","required":true},{"name":"amount","type":"decimal","required":false}]. Types are string, integer, decimal, boolean and date (YYYY-MM-DD). Inference is a suggestion; set explicit rules to detect incorrect data types reliably.
  • XML Inspector…: checks well-formedness, shows an expandable element tree and locates start tags in the source. Copy a node’s path or value, run node-selecting XPath queries, and enter namespace prefixes as JSON (for example {"x":"urn:example"}). Preview XML Formatting… opens Review Changes before applying. DTDs/external entities are disabled. XSD validation and XSLT are not included.
  • Column Tools…: choose a 1-based column and header setting. Sort text or numbers in either direction, align cells left/right as a plain-text display table, calculate a new column using c1 * c2and convert Unix seconds/milliseconds to ISO 8601 or ISO timestamps to Unix seconds. Use an IANA time zone such as UTC or America/Chicago. Calculations use floating point; keep identifiers as strings. Sorting equal keys retains their original order. Every edit opens Review Changes and can be undone.
  • Adaptive Tab Alignment: visually aligns tab-separated columns in the current editor view without inserting spaces or changing the source. Refreshes after typing. Limits: 2 MiB, 5,000 lines, 64 columns, 50,000 cells. It switches off if those limits are exceeded.

JSON and XML inspection: 4 MiB, 128 levels; JSON tree 100,000 nodes, XML tree 50,000 elements. Delimited checking: 4 MiB / 250,000 cells, up to 1,000 reported issues. XPath: node queries up to 2 KiB, 10,000 results and 16 MiB output. These tools do not execute user code or download plugins.

Macros and described changes

Describe a cleanup in plain language, record your edits, or teach by example - then replay the saved macro locally, without AI.

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.

Apple Intelligence and privacy

  • Described changes use Apple’s on-device model. Turn on Apple Intelligence in System Settings and wait for its model to finish downloading. Otherwise you’ll see a message saying so; all other tools still work.
  • Your document is not given to the model. Only your instruction (and any examples you type) is interpreted; the resulting commands run on your text locally.
  • A few common phrasings (such as highlighting decimal numbers in yellow) are recognized directly without the model.
  • The model can misunderstand. Always read the commands and result in the preview. Requests outside ZapPad’s command set are refused with an explanation, and nothing changes.

The Actions inspector

The panel on the right of the full editor. Hide it with its ×; show it again with Show action inspector in Settings. Its tabs:

TextDescribe Macro… and Generate Regex… (see below) · Record Macro… (start/stop recording) · Test Saved Macro… (pick a macro to replay) · Create from Examples… (Teach Macro).
CodeFormat Code (JSON or SQL pads; other languages get a hint) · Indent · Unindent · Outline… · Comment.
DataTable Tools… · Calculate… · Statistics…
Macro▶ Run shows saved macros · ● Record starts or stops recording. The scope reads Active Pad / Selection: macros use the selection, or the whole pad.

Describe Macro… and Generate Regex…

Both open a form with an Instruction and optional Examples (representative input/output or matching/non-matching lines, up to 4,000 UTF-8 bytes). Examples are sent to the on-device model with the instruction - avoid sensitive samples. Generate Regex… accepts only regex operations (replace, extract, keep, delete or highlight); otherwise it asks you to describe the match explicitly.

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.

Languages, JSON and Markdown

Syntax coloring, language detection and the read-only Markdown preview.

Choosing a language

  • The footer’s Syntax language menu lists None (Normal Text) and every language in A–Z submenus, plus your custom profiles.
  • Choosing a language manually overrides automatic detection for that pad.
  • View›Detect Language examines the text and picks a language, or says it’s ambiguous. The text isn’t changed.
  • View›Syntax Coloring turns coloring on or off; View›Detect Pasted Code and View›Auto Indent are independent toggles.

JSON tools

  • Check JSON Syntax… validates without changing text.
  • Clean Up Escaped JSON… turns "{\"name\":\"Ada\"}" into an indented object. It unwraps up to eight complete string layers, but won’t guess missing commas, fix trailing commas or decode string fields inside the object.
  • Format JSON… changes whitespace only.
  • Numbers (including large IDs and trailing zeros), key order and duplicate keys are preserved. Editable JSON is limited to 16 MiB.

Live Markdown Preview

Choose View › Live Markdown Preview or the footer’s MD Preview / Markdown? button. A read-only preview pane opens beside the editor and follows the whole active pad. Choose the command again to close it.

  • Headings, emphasis, fenced code blocks, lists, task checkboxes, quotes, rules and GitHub-style tables.
  • Updates automatically after a short typing pause. Sync scrolling follows relative position in both directions; it is not an exact source-line map.
  • Render Mermaid diagrams enables the bundled offline renderer for mermaid fenced blocks. This is off initially. Up to 20 diagrams, 32,000 characters per diagram and 128,000 total diagram characters.
  • Links are inert and images show alt text. Raw HTML is shown as text. Network requests are blocked, including inside diagrams.
  • Up to 512 KiB for the whole pad. Larger pads show a limit message; the source is unchanged. Mathematical typesetting and syntax-colored preview code blocks are not included.

Detect File Indentation

View › Detect File Indentation is enabled by default. Opening a file or pad samples existing indentation and applies tabs or a clear 2–8 space width without converting existing whitespace. Ambiguous or unindented files keep the configured default. Tabs use a four-column display width because a tab byte does not record the original editor’s display width.

Tab entry, Indent/Unindent and the existing Auto Indent setting use the detected style. Auto Indent is a separate toggle. Disable detection to return to the configured language/default style.

The View menu and window options

Display toggles, navigation between pads, reading options and code folding.

View menu items

Live Markdown PreviewSee Markdown preview.
Quick CaptureOpens the Quick Capture panel.
Full Editor ⇧⌘EOpens the full editor window.
Show Description BarToggles the description bar (checkmark when shown).
Show Library and Pad Search ⇧⌘LToggles the library sidebar.
Syntax ColoringToggles coloring for all pads.
Detect LanguageDetects the pad’s language once.
Detect Pasted CodeToggles automatic language detection on paste.
Detect File IndentationEnabled by default. Samples an opened pad’s indentation and matches tabs or a clear 2–8 space width without changing the text. Ambiguous files keep the configured default. Toggle under View.
Select Inside QuotesSearch → Navigate and Select: select the current line’s quoted content, excluding its delimiters. Handles escaped single/double quotes and backticks.
Surround SelectionTools → Surround Selection: wrap selected text in parentheses, brackets, braces, quotes, backticks, or a named tag. With an empty selection, inserts a pair with the caret inside. Undo reverses the operation in one step.
Auto IndentNew lines keep the previous line’s indentation (not for plain text).
Column Selection ⌥⇧⌘BToggles rectangular selection.
Next Pad ⇧⌘] · Previous Pad ⇧⌘[Switches tabs, wrapping around.
Word WrapWraps long lines to the window width.
Show Whitespace and Line EndingsDisplays spaces, tabs and line-ending markers.
Read-onlyPrevents edits to this pad in ZapPad (checkmark when on). It doesn’t change the file’s permissions.
Zoom In ⌘+ · Zoom Out ⌘−Changes the editor text size.

Window and Reading submenu

Always on TopKeeps the full editor above other windows.
Enter / Exit Full ScreenToggles macOS full screen.
Distraction-Free ModeHides the library, description bar and inspector; choose again to restore them.
Focus Other Split ViewMoves the cursor between split views.
Synchronize Horizontal ScrollingKeeps horizontal scrolling aligned across views.
Text Direction - Right to Left · Text Direction - Left to RightSets the editor’s text direction.
Clear File Read-Only Flag…Restores your write permission on the pad’s locked file, so it can be saved.

Folding submenu

Fold All, Unfold All, Fold Current Block, Unfold Current Block, and Fold Level / Unfold Level › Level 1–8. Folding depends on the language’s structure; when there’s nothing to fold, the status line says so.

File Browser

View › File Browser toggles an optional folder sidebar in the full editor. It stays hidden in quick capture and is created only when opened.

  • Choose Folder… grants access to a folder you select. Expand subfolders; double-click a file to open it through the normal file workflow.
  • Refresh reloads the folder. Show hidden files includes dot-prefixed entries. Symbolic links are excluded.
  • The filter searches names within the chosen folder, capped at 20,000 scanned entries and 2,000 matches; an individual folder listing is capped at 10,000 entries.
  • The star saves the current folder in Favorite folders…, up to 20 security-scoped bookmarks. If permission expires, choose the folder again.
  • View › Locate Current File finds the active file by name inside the chosen root. Choose its containing folder first if it is outside that root. This sidebar does not rename, delete or move files.

Settings

Open with ZapPad›Settings… (⌘,), the toolbar gear, or the menu bar icon.

All settings

The Settings window is grouped into Capture, Commands, Search and Appearance. Settings require Pro access.

SettingWhat it does
Keep capture available at loginInstalls the capture helper as a login item so the shortcut works when ZapPad isn’t running.
Double-tap Option to captureAdds a double-tap of Option as a capture gesture. Requires Input Monitoring permission.
Shortcut buttonShows the capture shortcut (e.g. Shortcut: ⌃⌥Space). Click it, then press a new combination including ⌘, ⌃ or ⌥; Esc cancels.
Use a daily pad for new capturesSee Daily pad.
Customize Command Shortcuts…Choose any menu command (except the ZapPad and Macros menus), choose Record Shortcut…, press a combination with ⌘, ⌃ or ⌥, then Save. Conflicts are rejected. Reset All restores defaults.
Index pads for semantic search and SpotlightOn by default. Lets pad search show related results. Turning it off clears the index.
AppearanceSystem, Light or Dark.
Editor themeNative, PowerShell Blue, Midnight, Forest or Paper.
Show action inspectorShows or hides the Actions inspector.
Window opacity85–100%. Reduce Transparency in macOS overrides it.
Reset AppearanceRestores System appearance, Native theme, 100% opacity and the inspector.

Keyboard shortcuts

Built-in defaults. You can change most of them in Settings › Customize Command Shortcuts…, so yours may differ.

Shortcut reference

ActionShortcut
Quick capture (anywhere)⌃⌥Space · with VoiceOver ⌃⇧Space
Dismiss Quick CaptureEsc
New Pad⌘N
Open…⌘O
Save · Save As…⌘S · ⇧⌘S
Close and Archive Pad⌘W
Reopen Last Closed Pad⇧⌘T
Undo · Redo⌘Z · ⇧⌘Z
Cut · Copy · Paste · Select All⌘X ⌘C ⌘V ⌘A
Find and Replace…⌘F
Find Next⌘G
Toggle Bookmark⌥⌘B
Preview Described Change⌘↩
Start / Stop Recording⇧⌘R
Run a saved macro⌥⌘ + its letter or digit
Full Editor⇧⌘E
Show Library and Pad Search⇧⌘L
Column Selection mode⌥⇧⌘B
Column select with keys · mouse⌥⇧ + arrows · ⌥-drag
Next Pad · Previous Pad⇧⌘] · ⇧⌘[
Zoom In · Zoom Out⌘+ · ⌘−
Settings…⌘,
Hide ZapPad · Quit ZapPad⌘H · ⌘Q
Minimize⌘M
Apply / Cancel in a preview or dialog↩ · Esc

ZapPad, Help and Window menus; privacy

The ZapPad menu

About ZapPad (version and credits) · ZapPad Pro… · Settings… (⌘,) · Services (provided by macOS) · Hide ZapPad (⌘H) · Quit ZapPad (⌘Q). Quitting saves your current pad first; if saving fails, ZapPad shows the error and stays open.

Help and Window menus

Help: ZapPad Help… opens this comprehensive guide; Open Cleanup Example (see First launch), Privacy Policy and Terms of Use, which open the published pages on evolute-llc.com. Window: Minimize (⌘M).

Privacy at a glance

  • Documents, drafts, preferences, macros and search indexes are stored locally on your Mac. ZapPad doesn’t send your documents to Evolute, and has no ZapPad account, cloud AI or third-party analytics.
  • Editing, transformations and supported Apple on-device model assistance run locally.
  • Direct license activation sends the key to Lemon Squeezy and the server-side coverage service; automatic trial issuance sends an app-scoped machine identifier and public device key to Cloudflare. Update checks/downloads contact GitHub-hosted endpoints. Apple-distributed builds use StoreKit instead of Direct licensing.
  • Clipboard history is optional, local and session-only.

Privacy & Trial Data… on the Pro screen explains the automatic trial and licensing connections. Read the Privacy Policy opens the notice. For access, correction or deletion, email hello@evolute-llc.com. Copy Privacy Reference copies a trial reference and public-key fingerprint, never a private key or document text. If support supplies a Support verification challenge, paste it here and choose Copy Verification Proof; return the proof in your existing support request. A verified request is reviewed before data is changed. Shared/merged records and payment-provider records require separate review. The app does not create an Evolute user account.

Read the full Privacy Policy and Terms of Use. Questions: hello@evolute-llc.com.

Troubleshooting and messages

What common messages mean and what to do.

Common messages

MessageWhat to do
Pro access is required…No trial or paid coverage applies to this build. Activate a valid Direct key, refresh saved coverage or use an entitled build. Restore Purchases applies only to Apple-distributed copies. Documents remain preserved.
The document changed. Generate a new preview before applying.The pad was edited after the preview was made. Run the tool again.
Disable read-only mode before applying changes.Turn off View›Read-only.
The selection is outside the document or splits a Unicode character.Reselect the text, or select nothing to use the whole pad. Most tools need a single selection, not multiple cursors.
Enable Apple Intelligence in System Settings…Described changes need Apple Intelligence and its downloaded model. Other tools work meanwhile.
This request needs an operation outside the current … command vocabulary.Rephrase as a regex replacement, extraction, filter or supported cleanup; or use a Text tool directly.
Examples must be at most 4,000 UTF-8 bytes.Use a smaller representative sample.
Recording stopped: …An action that can’t be replayed was used. Start recording again and use keyboard edits or tools.
Changed on disk. Reload or Save As…Another app changed the file. Reload from Disk to take its version (yours stays in history), or Save As to keep both.
File access unavailable…Reopen the file with File › Open… to grant access again.
Download was incomplete. Retry to resume. / Download failed (HTTP …)Reconnect and choose Download Full Packages again; it resumes from the partial download.
The operation was cancelled.You chose Stop or Cancel, or the task was superseded. Your text is unchanged; run the command again if needed.

Getting text back

  • Just applied something by mistake? Edit›Undo - each applied preview is one undo step.
  • Need an older state? File›Version History… keeps up to 100 revisions per pad.
  • Closed a pad? File›Reopen Last Closed Pad within 30 days.
  • Folder batch went wrong? Recover Last Batch in the Folder Search window.
  • Moving Macs? File›Back Up Pads…, then Import Backup… on the other Mac.

Limits at a glance

Editing transformations and JSON tools16 MiB of text
Regex highlight results100,000 matches
Search Results window2,000 rows shown
Pasted-data detection256 KiB
Markdown preview input512 KiB
Syntax-colored export2 MiB
Described-change examples4,000 UTF-8 bytes
Macro replay repeat count1–1,000, or end
Folder preview1,000 files / 64 MiB; files over 16 MiB skipped
Version history / macro versions100 each
Archived pads30 days
Clipboard history20 entries × 64 KiB, this session

ZapPad Help · © 2026 Evolute LLC. ZapPad requires macOS 12 or later on Apple Silicon. Apple, Mac, macOS, App Store and Apple Intelligence are trademarks of Apple Inc. Back to top