Getting the most out of Perch.

Perch is a quiet, fast clipboard manager for macOS — it watches your clipboard, keeps everything you've copied, and lets you find any of it again in a keystroke. This guide walks through how Perch captures, how to find things again, how the keyboard shortcuts work, and every option in Settings.

Step 1

How Perch captures #

Perch lives in your menubar and watches the system pasteboard. Every time you hit ⌘C in any app — text, a screenshot, a file in Finder, a swatch from a colour picker — Perch grabs a copy and tucks it into your history. You don't have to do anything; the app you copied from doesn't need to know Perch exists.

Auto-capture

Capture happens by polling the pasteboard a couple of times a second. It's how every macOS clipboard manager works — there's no event the system fires when you copy something, just a counter that ticks up. Perch checks that counter on a quiet timer and, when it changes, reads whatever the new contents are.

Two situations cause Perch to skip a copy on purpose: when Perch itself is the frontmost app (so re-pasting from history doesn't create a duplicate), and when the frontmost app is on your ignored list. Everything else is fair game.

What it stores

Perch reads the pasteboard in priority order and stores the highest-fidelity type it finds:

  • File URLs — anything you've copied from Finder. Stored as the file path so you can re-paste it into another app.
  • Images — PNG or TIFF. Stored as a file in Perch's image cache, capped at ~10 MB per image (anything bigger is skipped to keep your history light).
  • Rich text — RTF with formatting. Plain-text version is kept alongside, so you can paste it either way.
  • Plain text — the everyday case.
  • Colors — when a colour picker hands one over.

Application-specific data

Some apps put private pasteboard types alongside the regular ones — Figma copies layers, Sketch copies styles, Numbers copies cell formulas. Perch can capture those too, but it's off by default because it makes each clip bigger on disk.

Flip on Capture application-specific data in Settings → General and Perch will snapshot every pasteboard type the source app wrote. Pasting back into that same app then works natively — Figma layers paste as Figma layers, not as text. Clips that contain only private types show up as "Application Specific Data" in your history.

Size limits & dedupe

Text is capped at 100 KB per clip — if you copy a giant log file or a whole novel, the first 100 KB is kept and the rest is dropped. Images are capped at 10 MB. These limits exist so a single huge paste can't bloat your history into a slow, unmanageable thing.

Perch also dedupes — if the new clip matches the most-recent clip of the same type (compared by first 500 chars + length), it's silently ignored. Hammering ⌘C on the same selection three times won't fill your history with three identical rows.

How long Perch keeps history is up to you — the default is 3 months, but the slider in General settings runs from 24 hours all the way to "forever". Pinned items and anything in a collection never expire, regardless of the retention setting.

Step 2

Opening the panel #

Perch has two ways of showing your clipboard history. Both are equally capable — pick whichever feels less in the way.

The overlay panel — search at the top, smart filters below it, and your clipboard history as a scrollable list.

Global hotkey

The default global hotkey is ⌘⇧V — Cmd + Shift + V. Press it from anywhere on your Mac and Perch's panel appears, focused, ready for arrow keys or typing. Press it again to dismiss.

The hotkey is registered through Carbon's RegisterEventHotKey API — the only reliable way for a menubar app to claim a system-wide shortcut. You can rebind it under Settings → General → Global Hotkey: click the chord, press your new combination, done. At least one of Cmd, Control, or Option is required (Shift alone won't do).

Turn the hotkey off entirely if you'd rather only open Perch from the menu bar.

Menubar mode

Click the Perch icon in your menu bar and a popover drops down beneath it — classic macOS, like the Wi-Fi or volume menus. The popover is transient: click anywhere outside and it closes. Best when you're already mousing around and don't want to reach for the keyboard.

Overlay mode

The other option — and the default — is the overlay. A full-height panel slides in from the side of your screen, sits above whatever you were doing, and slides back out when you dismiss it. It's a lot of screen real estate so the list, previews, and command bar all have room to breathe.

Choose left or right edge in Settings → Appearance, and pick the animation — Slide (the default) or Fade. The slide animation translates the content layer inside a clipped window so it stays glued to one screen and never flashes onto an adjacent monitor.

Whichever mode you pick, Perch remembers which app you came from and hands focus back to it on dismiss. So ⌘⇧V → arrow down → in your text editor lands the paste exactly where your cursor was.

Step 4

Pins & Collections #

History is great for "the thing I just copied," but Perch also has two ways to keep specific clips around indefinitely — pins, for one-off anchors, and collections, for groups of related clips.

Smart collections sit above your own — both show a live count and survive Clear All.

Pinning

Pin any clip and it sticks. Pinned clips don't expire when your retention window passes, and they survive a Clear All. Useful for a wallet address you paste once a week, your home Wi-Fi password, the boilerplate intro to every cold email you send.

Smart collections

Perch ships with three smart collections that fill themselves automatically:

Links

Anything that parses as a URL. Useful when you've half-remembered "I copied that article yesterday" — filter to Links, type a word from the title.

Images

PNG/TIFF clips plus file URLs ending in image extensions (jpg, png, heic, webp, gif, svg, and friends).

A third smart collection, Documents, gathers file URLs ending in office-document extensions — PDF, DOCX, XLSX, Keynote, Pages, Numbers, RTF, CSV. Smart collections appear in the filter bar only when they actually contain items, so an empty Mac doesn't show a row of empty filters. Turn any of them off in Settings → Collections if you'd rather not see them.

Your collections

Create your own collections to group related clips. Naming a collection "Snippets" and dropping your most-used SQL queries and code blocks into it means they're one filter away from a paste at any time. Same for "Bills", "Drafts", "Onboarding emails" — whatever taxonomy fits your week.

Add a collection from Settings → Collections, or use ⌘⇧N with the panel open. Move a clip in via the Command Bar — every collection you've made shows up at the bottom of it. Items in a collection are kept forever — same as pinned items — and survive Clear All.

Step 5

The Command Bar #

Hit ⌘↩ or ⌘⇧C on a selected clip and the Command Bar opens — a small contextual menu of things Perch can do with that clip beyond a plain paste. The menu reads the clip's contents and offers only what makes sense for it; text clips show text transforms, URL clips show URL actions, files show file actions.

The Command Bar — contextual to the clip. Arrow keys move, Return runs the action.

Text transforms

Every text clip can be re-copied as UPPERCASE, lowercase, or Title Case. Rich-text clips get a "Copy as Plain Text" action that strips all the formatting — handy when you've copied something out of a styled web page and want it to land as bare text without bringing the source site's fonts and colours along for the ride.

Clips that look like code (indented blocks, common keywords) get two more options: Strip Indentation drops leading whitespace from every line, and Wrap in Code Block surrounds the text with triple-backticks for pasting into Markdown.

URL actions

When the clip is a URL the Command Bar swaps in:

  • Copy URL — the plain link.
  • Copy Domain Only — just the host. Good for noting where a quote came from.
  • Copy as Markdown Link — formats it as [domain](url), ready to paste into a Markdown doc.
  • Open Link — opens the URL in your default browser and dismisses Perch.

File actions

For file clips, the Command Bar offers Copy File Path (the full POSIX path), Copy File Name (just the filename), and Reveal in Finder. Reveal pops Finder open and selects the file in its parent folder — the same as Cmd-clicking a title bar.

Move to collection

At the bottom of the Command Bar, every collection you've created shows up as a destination. Picking one moves the current clip into that collection — Perch keeps the original in history too so you don't lose it. If the clip is already in a collection, a "Remove from Collection" option appears at the top of that list.

The Command Bar is keyboard-first. Arrow keys move through the list, runs the highlighted action, Esc closes the menu and leaves you back on the clip. You never need to reach for the trackpad.

Privacy

Ignored apps #

Some apps you never want Perch to look at — your password manager, your banking app, a notes app that holds private journal entries. The Ignored Apps list under Settings → Privacy fixes that. Anything copied while one of those apps is frontmost is invisible to Perch — no capture, no row, no file written.

Add an app by clicking Add App and picking it from the file picker that opens. Perch stores the bundle ID (e.g. com.1password.1password7) so the rule survives renames or version bumps. Remove an entry with the × next to its name.

Common candidates: 1Password, Bitwarden, your bank's Mac app, anything where "the next paste might leak" is a real worry. Perch doesn't ship with a preset list — the choice is yours, and there's no telemetry on what you pick.

Privacy

Privacy & data #

Your clipboard history is sensitive — every URL you ever clicked, every snippet you ever copied. Perch is built so all of that stays on your Mac, end of story.

  • No cloud sync. History never leaves the device. There's no server, no account, no iCloud anything.
  • No analytics on clip contents. Perch reports anonymous usage events — "the panel was opened", "a clip was pinned" — never what was in a clip.
  • Local storage only. Everything lives at ~/Library/Application Support/Perch/. history.json for clip metadata, collections.json for your collections, and an images/ directory for captured screenshots.
  • You can wipe it. Settings → General → Clear All Clipboard History permanently removes everything except pinned items and clips in collections. Or quit Perch and delete the folder above — same result.

The capture rules described under Ignored apps are your other line of defence: anything copied from an ignored app is never written to disk in the first place.

If you're worried about copies you've already made, Clear All takes about half a second and wipes the lot. Pinned items and collections stay — by design, so you don't lose a carefully curated set of snippets to a single misclick.

Reference

Keyboard shortcuts #

Perch is built so you almost never need the mouse once the panel is open. Here's the full set — also available from inside the app with ⌘?.

Show / hide Perch V
Move selection up / down
Next / previous collection Tab / Tab
Copy selected item
Copy selected item (alt) C
Open Command Bar
Open Command Bar (alt) C
Quick Look preview Space
Delete selected item
Quick copy 1st – 5th item 15
New collection N
Show shortcuts cheatsheet ?
Clear search / close panel Esc

Quick Look (Space) is worth a special mention — it pops up a full-size preview of the highlighted clip without leaving the list. For images you get the image; for text you get the whole thing in a scrollable view. ⌘C or ⌘↩ from inside Quick Look copies and dismisses both Quick Look and the panel in one go.

Preferences

Settings #

Open Settings with ⌘, or from the menubar icon. The sidebar is grouped — preferences at the top, then licensing, then About. Here's every option and what it does.

General

  • Launch at login. Whether Perch starts when you log into your Mac. On by default for direct downloads; off by default in the App Store build (asked during the welcome screen instead).
  • Always paste as plain text. Off by default. When on, every paste back to the clipboard drops rich formatting and writes only the plain-text version — the universal "stop bringing fonts along" toggle.
  • Capture application-specific data. Off by default. When on, Perch snapshots every pasteboard format so pasting back into the source app preserves private types (Figma layers, Sketch styles, etc.). Costs a little more disk per clip.
  • Keep history for. A slider with stops at 24 hours, 3 days, 1 week, 2 weeks, 1 month, 2 months, 3 months (default), 6 months, 1 year, and Forever. Older items are trimmed automatically.
  • Sounds. Two toggles — one for "play a Pop when you copy something from Perch," one for "play a Pop when a new clip is captured." Both off by default.
  • Global hotkey. Enable/disable + the chord recorder. Defaults to ⌘⇧V.
  • Clear All Clipboard History. The big red button. Removes everything that isn't pinned or in a collection.

Appearance

  • Theme. System, Light, or Dark. System (the default) follows your macOS appearance.
  • Display mode. Menubar (dropdown popover) or Overlay (slide-in panel). Overlay is the default.
  • Overlay side. Left or Right edge of the screen. Right by default.
  • Overlay animation. Slide (default) or Fade.
  • List style. Compact (dense rows) or Cards (default — bigger previews with metadata).
  • Link previews. On by default. When enabled, Perch fetches the title, description, and favicon for URL clips so they show up as proper previews in the list.

Collections

  • Smart collections. Three toggles — Links, Images, Documents — all on by default. Disabling one stops it appearing in the filter bar but doesn't remove any clips from your history.
  • Your collections. Add, name, and remove your own. Each gets an auto-assigned icon and brand colour from a built-in set; the count of items in each collection is shown alongside.

Privacy

The Ignored Apps list — see Ignored apps above. Apps you add here never have their copies captured.

Updates

Direct-download Perch updates itself in place. The Updates tab shows the current version, lets you toggle automatic checks, and offers a manual "Check now". App Store builds get updates through the App Store instead and don't show this tab.

License

Where you activate, manage, or deactivate your licence key. See the next section for what happens before you have one. The License tab is hidden in App Store builds (the App Store handles purchase).

Trial

Free trial & licence #

Perch has a 24-hour free trial — the full app, no feature gates, no watermark. Start it from the welcome screen and you've got a day to live with it and see if it fits. The trial timer counts down in real time and shows up in Settings → License.

Past 24 hours, you'll need a licence to keep using Perch. One licence is $19.99 — bought once, yours forever on this Mac, no subscription. Or pick up Unlimited and you get Perch plus every other General Software app for one monthly fee.

The licence validates online occasionally — every 6 hours while you're using Perch, and once on launch if you've got a key. If your Mac's offline for up to 7 days, Perch keeps working as normal; past that grace window it'll ask you to reconnect so it can re-check the key. That's the only network traffic from a paid Perch.

Tips

Things worth knowing #

Why didn't Perch pick up the thing I just copied?

A handful of reasons, in order of likeliness: the source app is on your Ignored list; the clip was a private pasteboard type Perch can't read (turn on Capture application-specific data in General settings); the copy was bigger than 100 KB of text or 10 MB of image; or you copied identical content twice in a row and Perch deduped the second one.

Can I get back to a clip I deleted?

No — deletes are permanent. Perch doesn't keep a trash. If you want a clip to stick around, pin it or move it to a collection; both are immune to Clear All and to retention expiry.

How big can my history grow?

With the default 3-month retention and average-size text clips, expect a few MB to a few tens of MB. Image-heavy use grows faster — each captured screenshot can be a megabyte or two. If you set retention to Forever Perch warns you in-app: the slider turns orange and reminds you that "unlimited history may use significant disk space over time."

What happens if I copy something huge?

Text above 100 KB is truncated to the first 100 KB. RTF data above 200 KB is dropped (you keep the plain-text version). Images above ~10 MB are skipped entirely — Perch refuses to capture them. None of these will hang or stutter the app; the cap just kicks in quietly.

Will Perch sync between my Macs?

No — by design. Clipboard contents are some of the most sensitive data on your machine, and a sync server would mean a copy of it sitting somewhere we don't control. Perch is local-only, and that's the contract.

I changed display modes and the hotkey stopped working.

Open Settings → General and check the Global Hotkey section. If you recently recorded a new chord while the app was in an odd state, the key may have failed to re-register. Toggling the "Enable global hotkey" switch off and back on re-registers cleanly.

Can I export my history?

Not from within Perch. If you need to, the underlying file is plain JSON at ~/Library/Application Support/Perch/history.json — open it in any text editor and the structure is straightforward. Images sit next to it in images/.

That's everything Perch does.

navigate open close