https://github.com/rumi7911/clipspot
A native macOS clipboard manager for text, images, videos, and file references. ClipSpot keeps a fast, searchable, local-first clipboard archive in your menu bar.
https://github.com/rumi7911/clipspot
accessibility copy-paste macos menu-bar menubar-app swift utility
Last synced: 2 months ago
JSON representation
A native macOS clipboard manager for text, images, videos, and file references. ClipSpot keeps a fast, searchable, local-first clipboard archive in your menu bar.
- Host: GitHub
- URL: https://github.com/rumi7911/clipspot
- Owner: rumi7911
- License: other
- Created: 2026-04-28T14:26:15.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-30T18:29:50.000Z (2 months ago)
- Last Synced: 2026-04-30T20:14:31.083Z (2 months ago)
- Topics: accessibility, copy-paste, macos, menu-bar, menubar-app, swift, utility
- Language: Swift
- Homepage: https://clip-spot-website.vercel.app/
- Size: 2.54 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# ClipSpot
ClipSpot is a native macOS clipboard manager built for fast, local-first workflows. It keeps a searchable archive of copied text, images, videos, and file references directly in your menu bar, without turning your clipboard history into a cloud product.
## Why ClipSpot
Most clipboard managers treat everything like plain text. ClipSpot is designed for modern Mac usage, where copied content often includes screenshots, images, videos, design assets, documents, and file references alongside text snippets.
ClipSpot focuses on:
- Native macOS menu bar workflow
- Local persistence with no cloud dependency
- Type-aware clipboard history for text, images, videos, and files
- Fast keyboard navigation and filtering
- Clear handling for missing file references
## Features
- **Clipboard archive**
ClipSpot stores recent clipboard history locally so copied items stay easy to recover.
- **Media-aware history**
Text, images, videos, and file references are recognized and grouped by content type.
- **Real-time file reference behavior**
Media files are stored as live references, not duplicated into an internal library. If the original file is deleted or moved, ClipSpot surfaces that clearly.
- **Keyboard-first usage**
Search, filter, move through visible results, and copy back from the keyboard without breaking flow.
- **Finder integration**
File-based clips can be revealed directly in Finder.
- **Local-first privacy**
Clipboard history remains on your Mac.
## Download
Download the latest public installer here:
[Download ClipSpot.dmg](https://github.com/rumi7911/ClipSpot/raw/main/downloads/ClipSpot.dmg)
## Latest Update
Version `0.2.1` fixes the Settings button so it opens the dedicated preferences window reliably and refreshes the public installer.
[Read release notes](CHANGELOG.md)
## First Launch on macOS
If macOS blocks the app on first launch because of Gatekeeper or quarantine attributes, remove the quarantine flag with:
```bash
xattr -dr com.apple.quarantine /Applications/ClipSpot.app
```
Run that only after you have moved `ClipSpot.app` into `/Applications`.
## Project Structure
```text
Sources/ClipboardShelf/ Swift source for the macOS app
Tests/ClipboardShelfTests/ Unit tests
assets/ App branding assets
script/ Local build and packaging scripts
```
## Development
### Requirements
- macOS
- Xcode Command Line Tools or Xcode
- Swift 6 toolchain compatible with the package
### Run tests
```bash
cd /Users/rumipro/Documents/MacApps/ClipSpot
DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer \
CLANG_MODULE_CACHE_PATH="$PWD/.build/ModuleCache" \
SWIFTPM_MODULECACHE_OVERRIDE="$PWD/.build/ModuleCache" \
swift test --disable-sandbox
```
### Build the app bundle
```bash
cd /Users/rumipro/Documents/MacApps/ClipSpot
./script/build_and_run.sh --bundle
```
### Package the DMG
```bash
cd /Users/rumipro/Documents/MacApps/ClipSpot
./script/package_dmg.sh
```
## Notes
- The repo tracks a public installer at `downloads/ClipSpot.dmg` for direct website downloads.
- The packaging script contains a fallback path for environments where mounted DMG creation is restricted.
## License
This project is available under a [personal-use-only, non-commercial license](LICENSE).