← Back to App Dashboard
📋

Maccy Production Guide

High-performance minimalist clipboard repository manager. SQLite vacuum operations, active credential filters injection, and positioning multi-screen coordinates overrides.

1. Production Installation Command

bash
brew install --cask maccy

2. Deep-Dive Maintenance & CLI Core Tuning Sheet

Target Operational Action / Hotkey Terminal Command Syntax / Core Tweak
Summon Popup History
Instantly display the core floating clipboard list precisely beneath your active mouse cursor coordinates.
⌘ + ⇧ + C
Ignore Rich Media Storage via CLI
Force-restrict Maccy to capture plain text objects only. This prevents heavy canvas images from clogging RAM.
defaults write org.p0deje.Maccy ignoreImages true
Hard Purge Historical SQLite File
Brute-force delete the entire local storage data index to completely wipe out cached strings and assets.
rm -rf ~/Library/Application\ Support/Maccy/history.sqlite
Verify Active Event Handlers
Check if the core clipboard polling loop is actively listening for system-wide copy operations.
defaults read org.p0deje.Maccy
Set Maximum Storage Limit
Clamp the total number of retained clipboard items down to 100 to maintain instant UI search speeds.
defaults write org.p0deje.Maccy size -int 100
Complete Subsystem Evacuation
Kill the active process tree, purge dynamic preferences caches, and trigger a clean boot environment.
pkill -9 Maccy && killall cfprefsd

3. Critical Troubleshooting & Crash Base

🚨 Error #1: Security Threat (Sensitive Passwords Leaking Into History Stack)

Root Cause: Maccy will read systemic clipboard changes globally unless explicit app bundles ignoring hooks are configured inside its defaults file layout registry. Force-ignore password managers payload schemas:

bash
defaults write org.p0deje.Maccy ignoredApps -array "com.agilebits.onepassword" "com.bitwarden.desktop"

🚨 Error #2: UI Lag & Slow Searching Loops (SQLite Database Fragmentation Mismatch)

Root Cause: Deleting thousands of items manually leaves dead indexing space inside the app support storage stack. Optimize and reconstruct structural data clusters using vacuum scripts via Terminal:

bash
sqlite3 ~/Library/Application\ Support/Maccy/history.sqlite "VACUUM;" || pkill Maccy

🚨 Error #3: Floating Popup Menu Fails to Appear on Multi-Display Spaces

Root Cause: macOS CoreGraphics layers occasionally drop absolute frame positioning parameters on extended monitors layouts. Force layout anchoring markers back to active screen center coordinates:

bash
defaults write org.p0deje.Maccy popupPosition center && open /Applications/Maccy.app

🚨 Error #4: Broken Ingestion Streams (Accessibility Framework Access Dropped Loop)

Root Cause: Advanced input monitoring permissions break if local security hash tables lose alignment during security patches. Force-reset specific TCC privacy system records:

bash
tccutil reset Accessibility org.p0deje.Maccy && pkill Maccy