Kopipe User Manual

What Kopipe does

• Automatically saves everything you copy (⌘C, etc.) to a history: text, rich text, images, files, and URLs
• Lets you recall that history anytime with a shortcut (⇧⌘V by default) and paste it back
• Lets you organize frequently used clips with pinboards and color-coded labels
• Lets you pin snippets you use often to fixed slots for instant one-key pasting
• Automatically skips saving sensitive content such as passwords or one-time codes

First launch

1. The first time you open Kopipe, you'll see a language picker. Nine languages are supported: English, 日本語, 简体中文, Español, Deutsch, Français, 한국어, Bahasa Indonesia, and Tiếng Việt. You can change this later at any time in Settings.
2. A five-page tutorial follows: ① Never Lose a Copy Again (recall your history anytime with ⇧⌘V) ② Skip the Extra Copy Step (arrow keys select and copy at the same time) ③ Find Things Instantly (organize and filter with labels) ④ Your Go-To Snippets, One Key Away (introduces Fixed Paste) ⑤ You're Ready to Fly (wrap-up)
3. A free trial screen appears partway through the tutorial. See "12. Free Trial and Purchase" below for the details.
4. You can replay the tutorial anytime from the menu bar icon → "Show Tutorial...".

The menu bar icon

Kopipe lives in your menu bar and does not appear in the Dock. Clicking the icon gives you:

Copy and paste, the basic flow

1. Copy something as you normally would (⌘C, right-click → Copy, drag and drop, and so on). Kopipe automatically adds it to your history.
2. Press ⇧⌘V (the default shortcut) and the timeline window appears floating on screen.
3. Use ← → to select the clip you want to paste. The moment you land on a clip, it's already copied to your clipboard.
4. Press Enter to paste the selected clip into whichever app you were using.

Automatic paste vs. manual paste (important)

Whether pressing Enter pastes automatically depends on whether you've granted Kopipe the Accessibility permission on your Mac.

• With Accessibility permission granted: pressing Enter pastes the selected clip directly into the app you were using. You don't need to press ⌘V yourself.
• Without it: pressing Enter copies the clip to your clipboard and shows a short reminder to press ⌘V. Switch to where you want to paste and press ⌘V.

Because of Apple's App Store review guidelines, Kopipe (the App Store version) never shows an in-app prompt asking you to grant Accessibility access. If you'd like automatic pasting, grant it yourself:

1. Open System Settings
2. Go to Privacy & Security → Accessibility
3. Find Kopipe in the list and turn it on (use the "+" button if it isn't listed yet)

Once granted, Enter will paste automatically from then on.

Paste variations

The timeline is a floating window that shows your copied history as a horizontal row of cards, newest first. Its size and position are remembered automatically.

Searching

With the timeline open, just start typing to begin a search (or press ⌘F to jump straight to the search field). Search covers the text or URL body, file names, any titles you've renamed, text extracted from images (OCR), and text inside PDFs. Results narrow down as you type (partial match, not case-sensitive). Press Esc to clear the search and close the timeline.

Previewing (Quick Look)

Select an image or file clip and press Space for a large preview. Press Space again to close it.

Right-click menu on a card

Right-clicking a card in the timeline gives you:

• Paste / Paste as Plain Text
• Copy to Clipboard (without pasting)
• Pin / Unpin
• Add a Label
• Rename
• Set as Fixed Slot 1, 2, or 3
• Delete

Confirmation before deleting

Ordinary clips are deleted immediately with the Delete key or right-click → Delete. However, if a clip you're about to delete matches either of the following, Kopipe shows a confirmation dialog first, to avoid accidental data loss:

• It has one or more labels attached
• It's assigned to a Fixed Paste slot (1, 2, or 3)

When deleting multiple clips at once, the dialog summarizes it as: "N clips, including M with labels or Fixed Paste slots. Delete all?"

Keyboard-only navigation

Reordering with ⌥← ⌥→ only works while you're viewing a pinboard or filtering by a label. It's disabled during a search and on the normal chronological timeline. Reaching the first or last position simply stops the movement.

Pinboards

Pinning a clip protects it from automatic deletion. Even after a clip's retention period expires and it's removed from the normal history, anything you've pinned stays in its pinboard.

• A default pinboard named "Pinned" is provided out of the box
• Create, rename, and delete pinboards from the Pinboards tab in Settings
• Pinboards are not shared or synced with other Macs; everything stays on this device

Labels

Labels let you tag clips with a color and category.

• Create, rename, recolor, delete, and reorder labels from the Labels tab in Settings
• A single clip can have multiple labels
• Selecting a label in the timeline's label bar filters the view to only clips with that label
• Turning on "Preserve labeled items" in the General tab also protects labeled clips from automatic deletion by retention period

Fixed Paste lets you pin up to three frequently used snippets to fixed slots, so you can paste any of them instantly with a single shortcut, without ever opening the timeline.

How to use it

1. Right-click any clip in the timeline and choose "Set as Fixed Slot 1", "2", or "3"
2. The assigned clip's card shows a small badge in its top-right corner, such as "⌃⌘1"
3. From any app, press ⌃⌘1 / ⌃⌘2 / ⌃⌘3 to paste that clip right where your cursor is

The Fixed Paste settings tab

The Fixed Paste tab in Settings shows the contents of all three slots, lets you change each slot's shortcut, and lets you clear an assignment with the "Clear" button. An empty slot shows "Empty — right-click a clip to assign."

Clips assigned to a fixed slot are exempt from automatic deletion by retention period, which makes this feature ideal for things like a frequently used address, a canned email reply, or a signature block.

Quick Paste (added in v1.11) lets you paste any of your 9 most recent clips directly from the menu bar with one click. Unlike Fixed Paste, its contents shift automatically every time you copy something new.

Turning it on

Quick Paste is off by default. To use it, go to the Shortcuts tab in Settings and turn on "Enable Quick Paste (⌘1–9)."

Once enabled, you can use it two ways:

• Shortcut: press ⌘1 through ⌘9 to instantly paste the 1st through 9th most recent clip, without opening the timeline
• Menu bar: click the Kopipe menu bar icon → "Quick Paste" to open the list, then click the clip you want to paste. If there's no history yet, it shows "No history yet"

If Accessibility permission isn't granted, Quick Paste behaves the same as a regular paste: the clip is copied to the clipboard and a "press ⌘V" reminder appears.

The backup feature (added in v1.11) lets you export your entire clip history, pinboards, and labels to a single file, then import it back later. It's also the recommended way to move your history to a new Mac.

Kopipe runs entirely on this device with no iCloud sync or similar. If you want to move your history to another Mac, use this backup feature.

Exporting a backup

1. Open the General tab in Settings
2. Click "Export Backup…" under the Backup section
3. Choose a save location. A package like Kopipe-Backup-2026-07-10.kopipebackup is created (it looks like a single file but is actually a folder-style bundle)
4. That bundle contains your full clip history database, any attached images and files, and a manifest with basic metadata

Importing a backup (restoring)

1. In the General tab, click "Import Backup…"
2. Choose the .kopipebackup file you exported earlier
3. A confirmation dialog appears. As it explains: "This merges the backup's clips, pinboards, and labels into your current history. Existing clips won't be duplicated or overwritten." Importing is a merge, not a replace
4. When it finishes, Kopipe reports how many clips were imported, how many were skipped as duplicates, and (if any) how many failed to restore

Moving to a new Mac

1. On your old Mac, run "Export Backup…" and move the resulting .kopipebackup file to your new Mac (USB drive, AirDrop, etc.)
2. Install and launch Kopipe on the new Mac
3. In the General tab, use "Import Backup…" and select the file
4. Your history, pinboards, and labels are now available on the new Mac

Clips with identical content are never added twice, so it's safe to import the same backup file more than once.

Fully offline

Kopipe never communicates over the network. Everything you copy is stored locally on this Mac (under ~/Library/Application Support/) and is never sent to any external server.

Automatically excluding sensitive content

Turning on "Filter sensitive content" in the Rules tab (whether this is on by default depends on your setup) prevents the following from ever being saved to history:

• Text that looks like a 13-to-19-digit credit card number, verified with the Luhn algorithm (so it only catches numbers that are actually valid in card-number format, not just any string of digits)
• Text matching a one-time passcode pattern, such as "verification code: 123456"

These are skipped silently, with no notification or log entry, so there's nothing left visible on screen even if the match happens to be wrong, and no need to worry about a popup interrupting your work.

Excluding specific apps

Add apps you don't want tracked (such as a password manager) to "Excluded Apps" in the Rules tab. While one of those apps is frontmost, anything you copy from it is not saved to history.

Retention period and automatic deletion

Choose a retention period in the General tab: 7 days, 30 days, 90 days, 1 year, or unlimited. Once a clip passes that age, it's automatically deleted, both from the database and any attached files.

The following clips are exempt from retention and are never automatically deleted:

• Clips in any pinboard
• Labeled clips, if "Preserve labeled items" is turned on
• Clips assigned to a Fixed Paste slot

Open Settings from the menu bar icon → "Settings..." (⌘,).

Key items in the General tab

• Launch at Login: automatically starts Kopipe when you log in to your Mac
• Retention period: how long clipboard history is kept before automatic deletion
• Enable deduplication: skips saving a copy if it's identical to the one right before it
• Preserve labeled items: exempts labeled items from automatic deletion
• Auto-extract text from images (OCR): makes text inside images searchable
• Display limit: the maximum number of clips shown in the timeline (50 / 100 / 200 / 500). Increasing this may slow the app down
• Select latest copied item when window opens: automatically selects the most recent clip when you open the timeline
• Card Size: the size of clip cards in the timeline (Compact / Large)

Global shortcuts

⇧⌘V, ⌘1–9, and ⌃⌘1–3 can all be reassigned from the Shortcuts tab and the Fixed Paste tab in Settings.

Inside the timeline

⇧⌘V doesn't open the timeline

Another app may be using the same shortcut. Try changing it to a different key combination in the Shortcuts tab in Settings.

Pressing Enter doesn't paste automatically

Automatic pasting requires Accessibility permission on your Mac. Without it, the clip is placed on your clipboard and a "press ⌘V" reminder appears instead. To enable automatic pasting, go to System Settings → Privacy & Security → Accessibility and turn on Kopipe.

Something I copied didn't show up in history

Check whether any of the following applies:

• The app you copied from is listed in Excluded Apps under the Rules tab
• The content matched a credit card number or one-time-passcode pattern and was filtered out by the sensitive-content filter
• It was identical to the previous clip and "Enable deduplication" is turned on
• Your trial has ended and you're looking further back than the last 24 hours (the history itself is still saved; only what's shown is limited)

What happens when the trial ends?

The app keeps working, but the timeline only shows clips copied in the last 24 hours. Anything older isn't deleted, it's simply hidden until you purchase Pro, at which point your full history becomes visible again immediately. You can still export a full backup of everything, even during the 24-hour-restricted period.

It says my trial ended, but I already purchased

Try "Restore Purchases" in the Pro tab. This restores your previous purchase under the same Apple ID and does not charge you again. If the issue continues, please reach out via "Send Feedback" in the About tab.

A backup import failed, or some clips didn't come back

The "failed" count shown after an import refers to individual clips that couldn't be restored, usually due to a corrupted or missing attached file. It doesn't mean the whole import failed. Double-check that the backup file itself isn't corrupted and try again.

The app feels slow

Try lowering the "Display limit" in the General tab. Higher settings like 500 clips can slow things down depending on your Mac.

Free trial

When you install Kopipe, a free trial starts automatically. Every feature is available during the trial.

• The trial runs for 3 days from a new install. If you were already mid-trial before this shorter trial policy took effect, you keep the original 14-day trial you started with
• The trial is tied to your install date, so uninstalling and reinstalling the app does not extend it
• If Kopipe detects that your Mac's system clock has been deliberately turned back, it treats the trial as expired as an anti-abuse measure (small changes from things like time zone or daylight saving adjustments are tolerated)

You can check your remaining trial days anytime in the Pro tab in Settings.

After the trial ends

Once the trial ends, the timeline only shows clips from the last 24 hours. Everything older stays saved, so purchasing Pro immediately restores access to your full history.

Purchasing Pro

• It's a one-time purchase of ¥900. There is no subscription and no recurring charge
• Purchase from the Pro tab in Settings
• Once purchased, the 24-hour viewing limit is removed and you can search and browse your entire history

Free access for early adopters (grandfathering)

If you installed Kopipe before April 1, 2026, 00:00 Japan time, you continue to get full access for free, forever. You won't even see a purchase prompt.

Restoring your purchase

If you get a new Mac or reinstall the app, tap "Restore Purchases" in the Pro tab. Kopipe checks your purchase history under the same Apple ID and restores Pro access. You will not be charged again.

Refunds

Refunds are handled by Apple, not by the developer, since the purchase is billed through the App Store. To request one, use Apple's "Report a Problem" page at reportaproblem.apple.com.