← Back to projectsNATIVE APP / MACOS 26

Clipurr.

Clipurr keeps a local history of copied text, images and files. Search finds earlier copies, including text recognized in images.

View implementation ↗SwiftUI · AppKit · Apple Vision
IN THE APP / SAMPLE CONTENT
Clipurr native history with a pinned note, image, file reference and SQL text
Your recent copies, together.
Search for React returns an image recognized by Apple Vision
Find a screenshot by the words inside it.
INTERACTIVE ILLUSTRATION / SAMPLE DATA

Search the history.

Search for React to find the image, or pin an item to keep it at the top.

  • Review the API contract · Workshop notes · project-notes.md
SAMPLE CONTENT

Review the API contract

Browser demo with sample data and pre-filled OCR text. Changes stay in memory; your clipboard is not accessed.

01 / THE PROBLEM

Go back to an earlier copy.

A new copy usually replaces the previous one. Clipurr keeps text, images and file references in a searchable list. You select an item and copy it again.

02 / ARCHITECTURE

How content moves through the app.

01

Capture

ClipboardMonitor watches NSPasteboard changes. ContentTypeExtractor identifies text, images or file references.

02

Store

HistoryStore removes duplicates. PersistenceManager saves the history to a local JSON file.

03

Find

OCRService runs Apple Vision in an actor. The recognized text stays attached to the item and can be found through search.

04

Re-copy

The list uses SwiftUI and the popover uses AppKit. Copying again can preserve RTF/HTML representations or use plain text.

03 / DECISIONS IN THE CODE

Find an image by what it says.

Recognition runs outside the UI. The image appears in the list before Vision finishes; the result is then attached to the item by its identifier. If OCR fails, the app keeps the item and returns empty text for search.

Pinned items stay at the top and survive automatic cleanup by count or age. You can still delete them manually. When the app copies an item again, it tells the monitor the write is its own to avoid adding another entry.

04 / STORAGE

History on the Mac.

The history is stored in a local JSON file. Apple Vision recognizes text in images on the Mac, so the image contents can be found through the same search as copied text.

Want to work together?

Send an email ↗