English | ็ฎไฝไธญๆ
Most clipboard managers available today fall into one of two extremes:
- Bloated Electron / Web apps that consume 200MB+ RAM, take seconds to launch, and drain your battery;
- Clunky legacy menu bars that look completely out of place in modern macOS;
- Expensive subscriptions charging $15-30/year for basic clipboard utilities, often with questionable cloud syncing.
LiquidClip is crafted with uncompromising care and pure native engineering: Built 100% with Swift 6 + SwiftUI + AppKit, zero external dependencies, launching in 0.02s with a mere ~15MB RAM footprint. Featuring Apple's native Liquid Glass (Frosted Acrylic/HUD Vibrancy) design with specular edge refractions, making clipboard management an absolute pleasure.
- Depth Frosted Translucency: System-level
NSVisualEffectViewHUD background that seamlessly adapts to your desktop wallpaper and Dark/Light appearance. - Specular Refraction Edge: Refined dual-gradient border with liquid reflection highlights along top and edges.
- Natural Fluid Springs: Every window reveal, hover state, and tab pill transition is driven by tuned spring dynamics.
- Discreet Menu Bar Accessory: Operates quietly in the menu bar with zero Dock clutter (
LSUIElementsupported).
LiquidClip doesn't just store raw textโit understands what you copy:
- ๐ Text:
- Live character, word, and line count statistics.
- Quick transformation tools: UPPERCASE, lowercase, Title Case, and Strip Whitespace.
- Powered by a virtualized asynchronous text engine that renders 50,000+ lines in milliseconds without UI freezes.
- ๐ผ๏ธ Images:
- Crisp high-resolution thumbnail preview, exact pixel dimensions (e.g.,
1920 ร 1080), and file formats. - One-click export to your "Downloads" folder, or copy image data directly.
- Crisp high-resolution thumbnail preview, exact pixel dimensions (e.g.,
- ๐จ Color Swatches:
- Automatically identifies
#HEXorrgb(...)color codes and generates a vibrant liquid color card. - One-click export to HEX, RGB, or SwiftUI
Colorcode.
- Automatically identifies
- ๐ Web URLs:
- Domain host & route breakdown with one-click launch in your default browser.
- ๐ Files & Folders:
- Displays genuine AppKit system file icons, filenames, and parent directories with "Reveal in Finder" action.
- Flexible Organization: Create named groups like "Code Snippets", "Canned Replies", or "Color Themes" with 21 curated SF Symbols.
- Zero-Purge Protection:
- Items assigned to custom groups are exempt from maximum history limits and never roll off.
- Clicking "Clear History" only wipes transient unfiled clips; custom grouped items are permanently protected.
- Instant Filing: Right-click any row to archive into a group, or toggle groups directly from the inspector header.
- Global Toggle: Press โ + โง + V anywhere to summon the HUD instantaneously (powered by Carbon API, sub-millisecond response) โ fully re-recordable in Preferences, no more conflicts.
- 1-9 Instant Quick Paste: The top 9 items feature quick numeric badges. Press 1 ~ 9 to paste directly into your active app without touching the mouse!
- Instant Search: Type immediately to search across content, source app names, colors, and filenames.
- Launch at Login: One-click login-item toggle in Preferences (built on
SMAppServicewith automatic fallback to legacy session login items) โ LiquidClip quietly reappears in your menu bar after every reboot.
- Password Manager Shield: Automatically ignores sensitive concealed types from 1Password, Bitwarden, KeePassXC, Apple Keychain, etc.
- Privacy Mode: One toggle keeps the entire session history in memory only โ nothing is ever written to disk; saving resumes automatically when disabled.
- Update Notices: A single GitHub Releases metadata check at launch surfaces new versions via a one-time-per-version dialog, a green badge dot on the menu-bar icon, an in-app banner, and a Settings entry.
- Backup & Rollback: Every save rotates a
.bakof the previous history file; a corrupt or schema-incompatible primary file automatically falls back to the last good backup. - Zero Telemetry: All clipboard data stays purely on your Mac in
~/Library/Application Support/LiquidClip/. The only network call ever made is the update check (public release metadata only).
| Feature / Metric | LiquidClip ๐ง | Maccy | Paste | Raycast Clipboard |
|---|---|---|---|---|
| Visual Aesthetic | Liquid Glass (HUD + Specular) | Classic Menubar Window | Screen-wide Bottom Cards | Dark/Light Flat Modal |
| Technology | Pure Native Swift 6 | Pure Native Swift | Native Swift | Node.js / React Host |
| RAM Footprint | ~15 MB | ~30 MB | ~120 MB+ | ~160 MB+ |
| Binary Size | ~1.8 MB | ~10 MB | ~50 MB+ | ~80 MB+ |
| Text Transformations | Upper/Lower/Title/Trim | โ None | โ None | |
| Color Swatch & Code Gen | Live Card + SwiftUI/CSS | โ None | โ None | |
| Protected Custom Groups | Permanent Anti-Purge | โ Pinned Only | โ Categorized | โ None |
| Network & Privacy | 0 Network Requests (Offline) | 0 Network Requests | ||
| Pricing | 100% Free & Open Source | Free / $9.99 Sponsor | $14.99/year Subscription | Free / Team Tier |
| Shortcut | Action | Description |
|---|---|---|
| โ + โง + V | Toggle LiquidClip | Summon or dismiss the HUD from anywhere |
| 1 ~ 9 | Direct Quick Paste | Instantly paste items 1 through 9 into your active app |
| โต (Enter) | Paste Selected | Paste the currently focused clipboard item |
| โ + C | Copy Only | Copy to system pasteboard without auto-pasting |
| โ + P | Favorite / Pin | Pin item (pinned items are never deleted during history cleanup) |
| โ / โ | Navigate | Move highlight up and down through the list |
| โซ (Backspace) | Delete Item | Remove the selected item from history |
| Esc | Smart Exit | Clear search text โ dismiss modals โ close window |
- Download
LiquidClip-v1.0.5.dmgfrom GitHub Releases; - Double-click the DMG and drag LiquidClip.app into your Applications folder;
- Launch LiquidClip and press โ + โง + V to begin.
Tip
Because LiquidClip is free open-source software built without an expensive Apple Developer ID certificate ($99/year), macOS Gatekeeper may show a warning upon first launch. You can bypass this in seconds using any of these methods:
- Method 1 (Easiest): In Finder, open
/Applications, Right-click (or Control-click)LiquidClip.app, select Open, and click Open in the dialog (only required once; macOS remembers your approval permanently). - Method 2: Double-click the
ๆไธๅผ็นๆ (่งฃ้ค็ณป็ปๅฎๅ จๆฆๆช).commandhelper script bundled directly inside the DMG. - Method 3: Open Mac System Settings -> Privacy & Security, scroll to the Security section, and click Open Anyway.
- Method 4: Run this one-liner in Terminal to remove the quarantine flag:
xattr -cr /Applications/LiquidClip.app
Prerequisites: macOS 14.0+, Xcode 15.0+ or Swift 6.0 toolchain.
# 1. Clone the repository
git clone https://github.com/Evander-8/LiquidClip.git
cd LiquidClip
# 2. Run the build script
./scripts/build_app.sh
# 3. Launch the app
open "dist/LiquidClip.app"To build a standalone DMG installer:
./scripts/build_app.sh --dmg- Auto-Paste: When you pick an item, LiquidClip simulates a keypress of โ + V to insert text into your active document or input field.
- This requires macOS Accessibility permission. If not granted, LiquidClip will gracefully copy the content to your pasteboard and remind you to paste manually.
- Click โ๏ธ Settings -> Authorize inside LiquidClip to jump straight to the macOS Settings page.
- Live Status Refresh: The Settings panel checks the permission in real time โ the badge flips to โ within a second of granting, no app restart needed.
- One-Click Trust Repair: If the toggle is ON in System Settings but LiquidClip still reports unauthorized (typical after a local rebuild, where an ad-hoc signature change invalidates the old TCC grant), click Repair Trust in Settings โ it resets the stale entry and re-raises the macOS grant prompt in one step.
LiquidClip is released under the MIT License. Contributions, bug reports, and suggestions are warmly welcome!