MaClipHistory

Native macOS clipboard history app.

This repository contains the Swift/SwiftUI + AppKit implementation of MaClipHistory.

What Works

• Menu bar status item with native template icon
• Popover
• Text clipboard monitoring
• Image, GIF, and small file clipboard monitoring
• Local JSON storage in Application Support
• Sidecar media/file storage in Application Support
• Search
• Click item to copy
• Copy and delete icon buttons
• Settings for theme, history length, and file capture size
• Clear history
• Reveal storage in Finder
• Quit action
• Shortcut to show/hide Cmd + Shift + V

Run

bash Scripts/run-app.sh

This creates and opens .build/MaClipHistory.app.

Build

HOME="$PWD/.swiftpm-home" swift build --disable-sandbox

Package A Free Community Build

bash Scripts/package-dmg.sh

This creates dist/MaClipHistory-arm64.dmg, the release asset used by the website download link.

The legacy ZIP package is still available:

bash Scripts/package-zip.sh

See INSTALL.md for the unsigned/ad-hoc signed installation flow. Users may need to right-click Open because these builds are not notarized.