PasteNote Usage Guide
A complete walkthrough of PasteNote, from activating the panel to every feature.
Download on the App Store🚀 Activate the Panel
PasteNote lives in the menu bar and never takes up Dock space. Once you set a global shortcut, you can summon the panel with one keystroke from any app, without switching away from the window you're editing.
- 1 After installing, the icon appears in the menu bar. Click it, or press the global shortcut (⌘⇧V by default, changeable in Preferences), to open the panel.
- 2 Don't want the icon always visible? Turn off "Show Menu Bar Icon" in Preferences — the icon hides, but the menu bar slot and the global shortcut still work.
- 3 The panel opens as a "non-activating" window: summoning it does not push the current foreground app to the background, so your cursor and work state stay exactly where they were.
- 4 Press Esc, or the activation shortcut again, to dismiss the panel anytime.
💡 The first time you open it, you'll see a few onboarding cards — hover or use arrow keys to preview each one. Once you copy your first real item, the onboarding disappears for good.
📋 Clipboard History
PasteNote automatically records everything you copy, sorted by type — search for it, or recall it instantly with ⌘1–9.
- 1 Just copy text, links, files, or images as usual — no extra steps, it's recorded automatically.
- 2 Switch between "History / Favorites / Notes / Custom Folders" tabs at the top of the panel: ⌘← / ⌘→ moves between tabs, ⌘0 jumps straight back to "All History" — the arrow keys here switch tabs, they don't move the selection between items.
- 3 Filter by type (text / links / files / images) within the panel.
- 4 Hover over any item to see a fuller preview.
- 5 Press ⌘1–9 to instantly write the corresponding numbered item back to the system clipboard, then paste it wherever you're working with ⌘V.
- 6 Hold Shift while copying (default, changeable to another modifier in Preferences) to record that item as plain text, stripping its original formatting.
- 7 Can't remember the exact content? Type a keyword into the search box to find it.
💡 ⌘1–9 only writes content back to the system clipboard — it does not simulate pressing ⌘V for you. That's intentional: PasteNote doesn't need the Accessibility permission.
📌 Desktop Notes
Found something you'll need again and again? Instead of summoning the panel every time, pin it as a note that floats on your desktop.
- 1 Select an item in clipboard history and press ⌘P (an in-app shortcut, changeable in Preferences) to pin it as a new desktop note.
- 2 Notes float on the desktop and can be freely dragged into place.
- 3 Switch to the "Notes" tab, select an existing note, and press ⌘P again: this time it won't create a new one — it toggles that note's floating window shown / hidden.
- 4 Want to pin quickly without opening the panel? The global shortcut ⌘⇧P (default, changeable) pins whatever is currently on the system clipboard as a note.
- 5 Too many notes open? The global shortcut ⌘⇧X (default, changeable) closes all note windows at once.
💡 Image notes additionally support pen / arrow / rectangle / circle annotation — see "Annotate a Screenshot After Pinning It" below.
⭐ Favorites & Organization
Clipboard history keeps growing — favorite the things you actually use often and organize them into your own folders, so they never get buried under newer items.
- 1 Click favorite on any item to add it to your favorites list.
- 2 Create custom folders to organize your favorited content.
- 3 Set a "maximum history size" in Preferences so history never grows without bound.
🔍 On-Device Text & QR Recognition
Copy a screenshot, and PasteNote automatically recognizes any text, QR code, or barcode in it, entirely on your Mac — no network access, no uploads. You can find an image just by searching the text inside it, and QR / barcodes can be copied or opened directly.
- 1 Copy a screenshot that contains text or a QR / barcode as usual (Simplified Chinese, Traditional Chinese, and English are all supported).
- 2 Recognition runs automatically on-device (no network access, no uploads) — no settings to open, and it never interrupts what you're copying next.
- 3 Later, type text that appeared in the image into the search box to find it (recognized text is used only for search, and isn't shown in the preview bubble).
- 4 Hover over the item — if a QR code or barcode was recognized, the preview bubble lists what was found; press ⌥⌘C to copy the recognized result, or ⌘O to open it directly in your browser if it's a valid link.
💡 Screenshots copied before this feature shipped won't be recognized retroactively. Recognition is on by default, and there's currently no separate toggle to turn it off.
✏️ Image Annotation
Once a screenshot is pinned as a desktop note, you can annotate it directly with a pen, arrows, rectangles, or circles — no need to switch to another image editor to report a bug or keep a record.
- 1 Copy a screenshot, then press ⌘P or click the pin button to turn it into a desktop note.
- 2 Enter annotation mode and choose a pen, arrow, rectangle, or circle from the toolbar.
- 3 Drag to draw; selecting a shape you've already drawn shows editing handles so you can resize and reposition it.
- 4 Hold Shift while drawing: rectangles are constrained to squares, circles to perfect circles, and lines to horizontal / vertical / 45°.
- 5 Once you're done annotating, download the image, or right-click to copy / save it.
💡 v1 only offers vector pen strokes and shapes — no mosaic / redaction tool, and it never modifies the original image's pixels.
🔒 Locking Sensitive Content
Content like passwords and verification codes is automatically detected and locked by default; you can also manually mark any item as "sensitive." Locked items are always redacted in the list; by default, hovering to preview still shows the plain text, but you can require an extra verification step in Settings for more security.
- 1 Password-like content the system recognizes (e.g., passed through the system password manager's clipboard) is recorded and locked automatically — no manual setup needed.
- 2 To lock an item manually: right-click and choose "Mark as Sensitive" — you can unlock it again anytime.
- 3 You can also mark an entire favorites folder as a "locked folder," and anything added to it automatically inherits the locked state.
- 4 Once locked, the content area of the list card is always redacted; by default, the preview bubble shown on hover displays the plain text directly, without requiring verification.
- 5 Want the preview to also require verification? Turn on "Require verification to preview locked content" in Preferences (off by default) — once enabled, hovering to preview triggers Touch ID / system password verification, and only shows the plain text after you pass it.
- 6 You can select and paste locked content directly without verification — this doesn't affect everyday use.
💡 Once preview verification is on, it only stays valid "for as long as the panel stays open this time" — close the panel, and you'll need to verify again the next time you summon it; it doesn't remember you indefinitely. Locking is a display-layer barrier, not encryption — it protects against "someone glancing at your screen," not against someone who can already unlock your Mac and inspect the database file directly.
⏸️ Recording Controls
Don't want a particular copy recorded, or want a specific app's (say, a password manager's) output to never enter history at all? PasteNote offers three levels of control, all of which take priority over every other feature.
- 1 One click on the menu bar icon to "Pause Recording" — nothing copied while paused is saved; click again to resume.
- 2 Just want to skip this one time? Choose "Ignore Next Copy," which affects only the very next copy operation.
- 3 Want a specific app's output to never be recorded, permanently? Add it to the "Ignored Apps" list in Preferences.
💡 These rules take priority over App Workspaces, favorites, search, OCR, and every other downstream feature — ignored content is never saved and then deleted; it never gets written to disk in the first place.
🗂️ App Workspaces
Code copied from Xcode and chat messages copied from WeChat mixed into the same timeline is hard to sift through. "App Context" automatically sorts by source app by default — you just choose which apps to pay attention to.
- 1 Preferences → General → "App Context" — the master switch is on by default (and can be turned off).
- 2 Add an app: choose from apps with recent copy activity, or manually pick any .app file.
- 3 Each added app has three independent toggles. "Enable this app's workspace": pause / enable categorization for just this one app, without affecting any other added app.
- 4 "Prioritize this app when summoned": summoning the main panel from this app shows only its history first; when off, summoning still shows all history, and you can switch manually.
- 5 "Auto-show bound notes": when this app comes to the foreground, its bound notes appear automatically, and hide automatically when you switch away.
- 6 To stop using workspace features for an app, just delete its configuration — history and notes already sorted under it are not deleted.
💡 The latter two toggles only take effect while "Enable this app's workspace" is on — they gray out when it's off, but keep their saved values and restore them once it's turned back on.
🔎 Filtered & Scoped Search
Can't remember the exact wording? Filter by type first, then narrow the scope to a specific folder or tab — search only looks within that scope, which is much faster than digging through all of history.
- 1 Filter by type (text / links / files / images) at the top of the panel first, then layer a keyword search on top.
- 2 Switch to a custom folder or the Favorites tab before searching, and it will only search within that folder / tab.
- 3 Exact match, prefix match, and tokenized matching are all supported.
💡 Search doesn't yet support Pinyin input — it needs to match the actual characters. Recognition and search both run entirely on-device and never touch a cloud LLM.
Want to try it now?
PasteNote is now available on the Mac App Store. Download it to get started.