Sovereign 8s.is mirror of 8b-is/klip
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Peter Lodri c0a481a8be
Some checks failed
CI / Build (macOS) (push) Has been cancelled
feat: image support, in-panel settings, About tab
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.
2026-04-22 00:18:33 +02:00
.github/workflows test: add KlipTests suite — 23 tests, 100% pass 2026-04-21 23:39:57 +02:00
Sources/klip feat: image support, in-panel settings, About tab 2026-04-22 00:18:33 +02:00
Tests/KlipTests feat: image support, in-panel settings, About tab 2026-04-22 00:18:33 +02:00
.gitignore feat: initial release — klip v1.0.0 2026-04-21 23:35:11 +02:00
CHANGELOG.md feat: initial release — klip v1.0.0 2026-04-21 23:35:11 +02:00
project.yml test: add KlipTests suite — 23 tests, 100% pass 2026-04-21 23:39:57 +02:00
README.md feat: initial release — klip v1.0.0 2026-04-21 23:35:11 +02:00

klip

A minimalist macOS clipboard manager that lives in the menu bar.

macOS 15+ Swift 6 CI

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