Historr docs

1. Download the latest Historr.dmg.
2. Open it and drag Historr into your Applications folder.
3. Launch Historr — a icon appears in the menu bar.

Historr is a universal app and runs on macOS 13 Ventura or later · Apple Silicon & Intel.

Or use the Terminal — one command downloads, installs to /Applications, and launches Historr, no drag-and-drop needed:

The app is signed with a Developer ID and notarized by Apple, so it opens right away — no security warnings, no extra steps.

Capturing your copy history needs no permission. To paste into other apps, Historr uses macOS Accessibility access — you'll be prompted on first launch.

To grant it manually:

1. Open System Settings → Privacy & Security → Accessibility.
2. Turn on Historr.

Historr remembers images too — not just text. Copy an image or take a screenshot to the clipboard and it appears in your history with a thumbnail.

1. Copy an image, or take a screenshot to the clipboard with ⌃⇧⌘4.
2. Open Historr with ⌥H — the image shows as a thumbnail labelled with its size.
3. Select it and press Return (or ⌘1–9) to paste the image into any app.
4. Press Space to preview the full image before pasting.

Images are stored locally on your Mac alongside your text history — nothing is uploaded. Text-only actions like transforms and the Paste Stack don't apply to images.

The Paste Stack lets you queue several clips and paste them in order — great for filling forms or moving values between fields.

1. Right-click items and choose Add to Paste Stack.
2. Switch to your target app.
3. Press ⌥⌘V repeatedly — each press pastes the next item.

A banner in the popup shows how many items remain; clear it anytime.

Right-click any clip → Paste as to reshape it on the way out:

• Plain Text · Trimmed
• lowercase · UPPERCASE
• slug-case · Pretty JSON

Historr recognizes what you copied and offers one-tap actions:

• URLs → Open Link
• Emails → Compose Email
• Hex colors → live swatch + Copy as RGB

Historr is 100% local — no cloud, no account, no telemetry. Copies from password managers (marked concealed/transient) are ignored automatically.

Auto-expire detects card numbers, one-time codes, and tokens and removes them after a few minutes. Toggle it and set the duration in Preferences → Privacy. Use Pause Recording in the menu bar for fully incognito work.

Click the ★ on any clip to favorite it — favorites pin to the top and survive Clear History. Deleted something by mistake? Press ⌘Z to bring it back (up to 10 levels).

• Launch at login — start Historr automatically.
• Max history items — how many clips to keep.
• Auto-expire sensitive copies — on/off + duration.

Open Preferences from the menu-bar icon or with ⌘,.