README.md
April 5, 2026 · View on GitHub
PasteClip
A lightweight clipboard manager for macOS
Screenshots
Features
- Clipboard History — Automatically saves text, images, and files you copy
- Quick Access Panel — Open with a global hotkey; non-activating panel keeps your current app focused
- Search — Instantly find items in your clipboard history
- Keyboard Navigation — Navigate and paste entirely from the keyboard
- Paste with One Click — Select an item to paste it directly into the frontmost app
- Image Support — Copies images as PNG + file URL so they work everywhere, including terminals
- Lightweight — Lives in the menu bar, uses minimal resources
- Privacy — All data stays local on your Mac using SwiftData
Installation
Homebrew (Recommended)
brew install --cask minsang-alt/tap/pasteclip
GitHub Releases
Download the latest .dmg from the Releases page.
Gatekeeper Warning: Since the app is not notarized, macOS may show a warning on first launch. To resolve: System Settings → Privacy & Security → scroll down → click "Open Anyway",
Build from Source
-
Install xcodegen:
brew install xcodegen -
Clone and build:
git clone https://github.com/minsang-alt/PasteClip.git cd PasteClip xcodegen generate open PasteClip.xcodeproj -
Build and run with
Cmd + Rin Xcode.
Usage
- Launch PasteClip — it appears as an icon in the menu bar.
- Copy anything as usual (
Cmd + C). - Open the panel with your configured hotkey (set in Preferences).
- Navigate with arrow keys or search by typing.
- Paste by pressing
Enteror clicking an item.
Tech Stack
| Component | Technology |
|---|---|
| Language | Swift 6 (strict concurrency) |
| UI | SwiftUI + NSPanel (non-activating) |
| Data | SwiftData |
| Target | macOS 14+ |
| Dependencies | KeyboardShortcuts |
| Build | XcodeGen |
Contributing
Contributions are welcome! Please read the Contributing Guide before submitting a pull request.
License
This project is licensed under the GNU General Public License v3.0.
Acknowledgments
- KeyboardShortcuts by Sindre Sorhus — Global keyboard shortcuts for macOS
- XcodeGen by Yonas Kolb — Xcode project generation from YAML
Privacy
- Local-only storage: Clipboard history is stored on your device.
- No servers / no accounts: PasteClip does not use any backend server and does not require sign-in.
- No telemetry: PasteClip does not collect analytics, tracking, or usage data.
- No network required: Core functionality works fully offline and does not require an internet connection.