Skip to content

About

๐Ÿ’ง A lightweight, native macOS clipboard history manager built with Liquid Glass aesthetics (Swift 6 + SwiftUI + AppKit)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

ย 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

English | ็ฎ€ไฝ“ไธญๆ–‡

LiquidClip App Icon

๐Ÿ’ง LiquidClip

The Lightweight, Native Liquid Glass Clipboard History Manager for macOS

Release macOS 14.0+ Apple Silicon Swift 6 Bundle Size Memory License

Download DMG


๐Ÿ’ก Why LiquidClip?

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.


โœจ Features

๐ŸชŸ 1. Native Liquid Glass Aesthetics

  • Depth Frosted Translucency: System-level NSVisualEffectView HUD 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 (LSUIElement supported).

๐Ÿ“‹ 2. Smart Multi-format Inspection

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.
  • ๐ŸŽจ Color Swatches:
    • Automatically identifies #HEX or rgb(...) color codes and generates a vibrant liquid color card.
    • One-click export to HEX, RGB, or SwiftUI Color code.
  • ๐Ÿ”— 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.

๐Ÿ“‚ 3. Custom Groups with Permanent Deletion Protection

  • 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.

โšก 4. Keyboard-Driven Workflow

  • 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 SMAppService with automatic fallback to legacy session login items) โ€” LiquidClip quietly reappears in your menu bar after every reboot.

๐Ÿ”’ 5. Privacy by Design & 100% Offline

  • 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 .bak of 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).

๐Ÿ“Š Comparison

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 โš ๏ธ Multi-step
Color Swatch & Code Gen Live Card + SwiftUI/CSS โŒ None โŒ None โš ๏ธ Plain text
Protected Custom Groups Permanent Anti-Purge โŒ Pinned Only โœ… Categorized โŒ None
Network & Privacy 0 Network Requests (Offline) 0 Network Requests โš ๏ธ iCloud Dependent โš ๏ธ Cloud Account
Pricing 100% Free & Open Source Free / $9.99 Sponsor $14.99/year Subscription Free / Team Tier

โŒจ๏ธ Keyboard Shortcuts

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

๐Ÿš€ Installation

Option 1: Pre-built DMG Installer (Recommended)

  1. Download LiquidClip-v1.0.5.dmg from GitHub Releases;
  2. Double-click the DMG and drag LiquidClip.app into your Applications folder;
  3. Launch LiquidClip and press โŒ˜ + โ‡ง + V to begin.

Tip

macOS Gatekeeper ("Cannot be opened" / "Unverified Developer")

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 ๆ‰“ไธๅผ€็‚นๆˆ‘ (่งฃ้™ค็ณป็ปŸๅฎ‰ๅ…จๆ‹ฆๆˆช).command helper 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

Option 2: Build from Source

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

โš™๏ธ Accessibility Permissions

  • 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.

๐Ÿ“„ License

LiquidClip is released under the MIT License. Contributions, bug reports, and suggestions are warmly welcome!

Made with ๐Ÿ’ง and Swift for macOS by Evander-8

About

๐Ÿ’ง A lightweight, native macOS clipboard history manager built with Liquid Glass aesthetics (Swift 6 + SwiftUI + AppKit)

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages