Sovereign 8s.is mirror of 8b-is/klip
- Swift 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
Some checks failed
CI / Build (macOS) (push) Has been cancelled
Image ingest: NSImage → JPEG thumbnail (240px, q0.6) + full (2048px, q0.85). Hard skip if raw decode fails or compressed full > 5MB. Memory budget: evict oldest image clips if total full-size data exceeds 50MB. ClipRowView: shows thumbnail preview for image clips instead of SF Symbol. Settings: removed external Settings scene; gear opens inline panel with slide transition. Two tabs — General (history limit + clear) and About (version + feedback link). No external window opened. Tests: updated image fixture to new .image(thumbnail:full:pixelSize:) case. All 23 tests green. |
||
| .github/workflows | ||
| Sources/klip | ||
| Tests/KlipTests | ||
| .gitignore | ||
| CHANGELOG.md | ||
| project.yml | ||
| README.md | ||
klip
A minimalist macOS clipboard manager that lives in the menu bar.
Features
- Menu bar only — no Dock icon, no clutter
- Instant capture — polls the clipboard every 0.5 s for text and images
- Click to paste — click any clip to copy it back to the clipboard
- Configurable history — keep 5 to 100 items (default 20)
- Lightweight — SwiftUI +
@Observable, zero third-party dependencies
Requirements
| Minimum | |
|---|---|
| macOS | 15.0 Sequoia |
| Xcode | 16.0 |
| Swift | 6.0 |
Build
brew install xcodegen
xcodegen generate
open klip.xcodeproj
Then Cmd+R in Xcode. The clipboard icon appears in the menu bar immediately.
Project structure
klip/
├── project.yml # XcodeGen spec — source of truth for the project
└── Sources/klip/
├── KlipApp.swift # App entry, MenuBarExtra + Settings scenes
├── ClipboardMonitor.swift # @Observable model, NSPasteboard polling
├── ClipItem.swift # Value type: text or image content
├── ClipboardPanelView.swift # Menu bar panel — header, list, footer
├── ClipRowView.swift # Individual clip row with hover/delete
└── SettingsView.swift # Max items + clear all
The Xcode project file (*.xcodeproj) is generated from project.yml and is git-ignored. Run xcodegen generate after cloning or after editing project.yml.
CI
GitHub Actions builds the app on every push and pull request to main using the macos-15 runner and Xcode 16. See .github/workflows/ci.yml.
Roadmap
- Image/media preview in the panel (with memory-safe ingest guard)
- About tab in Settings
- Liquid Glass panel on macOS 26
- Global keyboard shortcut to summon/dismiss the panel
License
MIT