Clipo

A Paste-style clipboard manager for macOS — horizontal card carousel at the bottom of the screen, built with SwiftUI + SwiftData.

Everything you copy becomes a card. Hit ⇧⌘V, arrow through history, press ⏎ to paste into the app you just came from.

中文说明

• Bottom-of-screen carousel — full-width translucent panel, 220pt card grid, slides up on ⇧⌘V
• Text, images, files, URLs, colors — each clip type gets a tailored card body
• Drag out — any card drags into Finder, editors, browsers, chat apps. Files drag as the original URL (no copy); text/images/colors serialize lazily to a temp file only on drop
• Multi-select + paste-stack — Shift-click a range or ⌘-click to toggle individual cards, then ⏎ pastes them in your click order
• Pinboards — create named boards (Snippets / Code / Quotes…) with their own accent color. ⌘P moves the current item, ⌘1-9 jumps between tabs
• Search — exact / contains / fuzzy modes, highlights matches inline
• OCR on images — screenshots become searchable by their contents (Vision framework, off-main)
• Scripts — user-defined JavaScript transforms (trim whitespace, format JSON, URL-decode…) exposed in the card right-click menu
• Ignore rules — per-app, per-pasteboard-type, or per-regex patterns keep passwords and secrets out of history
• clipocli CLI — installed alongside the app, lets you query/paste from scripts and shell

• macOS 14 Sonoma or later
• Accessibility permission (needed to inject ⌘V into the frontmost app)

Grab the latest Clipo-*-arm64.dmg from Releases, drag Clipo.app into /Applications, and launch it. Grant Accessibility permission when prompted.

# Generate the Xcode project (uses XcodeGen; install via brew if missing)
brew install xcodegen
xcodegen

# Debug build
xcodebuild -project Clipo.xcodeproj -scheme Clipo -configuration Debug build

# Release DMG in one shot (clean → build → package → open in Finder)
bash scripts/package.sh

# Apple-Silicon-only build (matches the CI workflow output)
ARCHS=arm64 bash scripts/package.sh

Everything user-facing is configurable via the ⌘, Settings window — split across seven panes: General (hotkeys, paste defaults, search mode), Appearance (menu bar icon, accent color, panel dimensions), Storage (history size, per-type toggles, sort order), Pinboards, Scripts, Ignore (apps / pasteboard types / regex patterns), and Advanced (pause monitoring, accessibility status, diagnostics).

• UI: 100% SwiftUI inside a borderless NSPanel anchored to the bottom edge
• Storage: SwiftData with a single ModelContainer under ~/Library/Application Support/Clipo/Storage.sqlite
• Clipboard engine: NSPasteboard.changeCount polling at 0.5s (configurable), type whitelist, internal marker to prevent paste loops
• Paste: CGEvent-injected ⌘V into the frontmost app (Maccy's approach)
• Scripts: JavaScriptCore sandbox, 500ms timeout per invocation, one JSContext per script for isolation
• Drag-out: SwiftUI .onDrag with NSItemProvider.registerDataRepresentation lazy file-URL loader, panel fades during drag to keep compositing cost off the critical path
• Search: Fuse-swift for fuzzy matching; debounced per-keystroke

Clipo/
├── App/             # AppDelegate, status bar, drag lifecycle
├── Clipboard/       # ClipboardEngine, Paster, Accessibility prompt
├── Hotkeys/         # Global + window-local shortcut registration
├── IPC/             # clipocli bridge (Unix-socket server)
├── Models/          # ClipItem, ClipContent, Pinboard (SwiftData)
├── Scripts/         # JS script runtime + built-in examples
├── Settings/        # 7 preference panes
├── State/           # AppState (@Observable, MainActor-bound)
├── Storage/         # SwiftData ModelContainer
└── UI/              # Panels, carousel, cards, design tokens

• Defaults — type-safe UserDefaults
• KeyboardShortcuts — user-rebindable hotkeys
• Settings — preferences window toolbar
• LaunchAtLogin — login-item toggle
• Fuse — fuzzy search

• Everything stays local. No network calls, no telemetry, no iCloud.
• ~/Library/Application Support/Clipo/Storage.sqlite holds all history.
• Sensitive items marked .concealed or .autoGenerated (password managers, Keychain, etc.) are skipped automatically.
• Apple's Passwords.app and Keychain Access are ignored by bundle ID out of the box; add more apps or regex patterns in Settings → Ignore to exclude other sources.

Inspired by Paste (UI) and Maccy (clipboard engine).