इस प्रोजेक्ट के बारे में

Gancho — स्पेनिश में "हुक" — Apple प्लेटफॉर्म परिवार के लिए एक MIT-लाइसेंस प्राप्त, local-first क्लिपबोर्ड हिस्ट्री और क्यूरेटेड स्निपेट लाइब्रेरी है। README इसे सक्रिय विकास में सार्वजनिक v0.8.3 के रूप में वर्णित करता है, जिसका लक्ष्य 1.0 है, जिसमें macOS प्राथमिक क्रिएशन सरफेस है, एक्सटेंशन सपोर्ट के साथ iPhone/iPad ऐप्स हैं, एक नियोजित iPad-संगत visionOS बिल्ड है, और watchOS केवल पिन्स और हालिया आइटम तक सीमित है। Android, Windows और Linux को केवल भविष्य के विश्लेषण के रूप में सूचीबद्ध किया गया है, उनके कार्यान्वयन की कोई प्रतिबद्धता नहीं है। macOS पर कैप्चर और प्राइवेसी को एक पेस्टबोर्ड मॉनिटर द्वारा संभाला जाता है जो एडेप्टिव लो-पावर पोलिंग का उपयोग करता है। यह स्क्रीन लॉक और प्राइवेट मोड पर रुक जाता है, अपने स्वयं के राइट्स को दबा देता है, Universal Clipboard आइटम को फ्लैग करता है और टेक्स्ट, RTF, HTML, इमेज और फाइल URL जैसे रिच पेलोड को रखता है। ConcealedType, TransientType या AutoGeneratedType के रूप में चिह्नित पेस्टबोर्ड प्रकार किसी भी सामग्री को पढ़ने से पहले कैप्चर को वीटो कर देते हैं, और इसमें एक प्रीलोडेड पासवर्ड-मैनेजर और बैंकिंग डिनylist के साथ-साथ एक "ignore next copy" एक्शन शामिल है। एक ऑन-डिवाइस डिटेक्टर कार्ड नंबर (Luhn), AWS/Stripe/GitHub/Slack कीज़, PEM कीज़ और संभावित पासवर्ड की तलाश करता है, और संक्षिप्त समाप्ति के साथ मास्क किए गए प्रीव्यू दिखाता है। iOS, iPadOS और visionOS पर, कैप्चर केवल जानबूझकर (intentional) होता है — कोई बैकग्राउंड पेस्टबोर्ड पोलिंग नहीं होती। प्रोजेक्ट का कहना है कि क्लिपबोर्ड सामग्री कभी भी लॉग्स, टेलीमेट्री, क्रैश रिपोर्ट, एनालिटिक्स या सपोर्ट बंडल्स में नहीं लिखी जाती है। स्टोरेज के लिए GRDB/SQLite का उपयोग किया जाता है जिसमें कंटेंट-एड्रेस्ड डिस्क ब्लब्स, लेजी थंबनेल, पेज्ड मेटाडेटा-ओनली लिस्ट, वर्जनड माइग्रेशन, डिवाइस-अवेयर डिडुप्लीकेशन और JSON/CSV एक्सपोर्ट शामिल हैं। सर्च FTS5-आधारित है जिसमें सटीक, फजी और regex मोड के साथ-साथ प्रकार, सोर्स ऐप और तारीख के लिए फिल्टर हैं, जिसे 100k-आइटम परफॉरमेंस हार्नेस द्वारा सपोर्ट किया जाता है। एक 512-डायमेंशन ऑन-डिवाइस एम्बेडिंग इंडेक्स "Ask your clipboard" फीचर और ऑटोमैटिक बोर्ड सुझावों को पावर देता है, जबकि मुख्य हिस्ट्री सर्च FTS5 ही रहता है। एक रिटेंशन इंजन ग्लोबल और प्रति-प्रकार समाप्ति, संवेदनशील ऑटो-एक्सपायरी और बैकग्राउंड पर्जिंग लागू करता है, जिसमें पिन्स को छूट दी गई है। macOS ऐप एक मेनू-बार एजेंट है जिसमें एक रिसाइज्ड फ्लोटिंग हिस्ट्री पैनल (Shift-Cmd-V), कीबोर्ड-फर्स्ट टाइप-टू-सर्च, कंपोजेबल फिल्टर, एडिटेबल टाइटल, प्रति-प्रकार प्रीव्यू, एक रीड-ओनली फुल-कंटेंट प्रीव्यू और सिंथेटिक Cmd-V के माध्यम से पेस्ट-बैक की सुविधा है। पिन्स, मल्टी-मेंबरशिप बोर्ड और बोर्ड और स्निपेट्स के लिए एक एकीकृत लाइब्रेरी लागू की गई है, साथ ही बैच ऐड-टू-स्टैक, ऐड-टू-बोर्ड और अनडू के साथ डिलीट, मल्टी-सिलेक्शन, फाइल क्लिप्स को ड्रैग करना, स्ट्रक्चरल रिडक्शन के साथ क्यूरेटेड Spotlight डोनेशन, और रीड-ओनली प्रीव्यू, वैलिडेशन, एटॉमिक डिडुप्लीकेशन और कैंसलेशन के साथ एक गाइडेड Maccy/CSV हिस्ट्री इम्पोर्ट शामिल है। Raycast स्पष्ट रूप से इम्पोर्ट सोर्स नहीं है, क्योंकि इसका प्रलेखित क्लिपबोर्ड API केवल छह हालिया प्रविष्टियों को उजागर करता है और इसके एन्क्रिप्टेड बैकअप का कोई प्रलेखित थर्ड-पार्टी डिकोडिंग स्कीमा नहीं है। iPhone और iPad ऐप केवल Save बटन, UIPasteControl, एक Share Extension और App Intents/Shortcuts के माध्यम से जानबूझकर कैप्चर की सुविधा देता है, साथ ही हिस्ट्री के साथ एक कीबोर्ड एक्सटेंशन, विजेट्स, iPad स्प्लिट व्यू और सोर्स-ऐप फिल्टरिंग प्रदान करता है। इसका ऑन-डिवाइस इंटेलिजेंस स्टैक शून्य नेटवर्क के साथ काम करता है: एक डिटरमिनिस्टिक टियर-0 क्लासिफायर जो 5ms से कम समय में 17 प्रकार की सामग्री को पहचानता है, Apple Intelligence टाइटल्स, स्क्रीनशॉट OCR, सिमेंटिक इंडेक्सिंग, Dev Actions (JWT डिकोड, JSON फॉर्मेटिंग, Base64, URL पार्सिंग, कलर कन्वर्जन, UUID फॉर्मेट्स) जो App Intents के रूप में भी उपलब्ध हैं, Smart Paste रीराइट्स/ट्रांसलेशन/PII रिडक्शन, हिस्ट्री पर आधारित ग्राउंडेड Q&A, और ऑटोमैटिक बोर्ड सुझाव। इंटेलिजेंस स्क्रीन पर प्रत्येक चरण का अपना टॉगल है। सिंक के लिए SyncEngine बाउंड्री के पीछे यूजर के निजी iCloud डेटाबेस पर CKSyncEngine का उपयोग किया जाता है, जिसमें एक दृश्य सिंक स्टेटस होता है। इंटीग्रेशन में एक gancho CLI, एक्सपायरिंग और रिवोकेबल प्रति-क्लाइंट ग्रांट्स के साथ एक लोकल ऑप्ट-इन MCP सर्वर, स्पष्ट बोर्ड/टाइम कॉन्टेक्स्ट, स्वतंत्र रीड/राइट परमिशन और एक मेटाडेटा-ओनली एक्सेस लॉग, साथ ही एक VS Code "Save Selection" कमांड शामिल है। मोनेटाइजेशन के लिए StoreKit 2 परचेज, रिस्टोर और एंटाइटेलमेंट प्लंबिंग का उपयोग किया जाता है जिसमें एक कॉन्टेक्स्टुअल पेवॉल और फ्री-टियर लिमिट्स हैं; डायरेक्ट-डाउनलोड बिल्ड बिना पेमेंट सीक्रेट एम्बेड किए Lemon Squeezy के माध्यम से Pro लाइसेंस खरीद, एक्टिवेट, रीवैलिडेट और डीएक्टिवेट कर सकता है, और Pro एन्क्रिप्टेड iCloud सिंक को अनलॉक करता है। वैकल्पिक अनाम डायग्नोस्टिक्स स्पष्ट सहमति तक अक्षम रहते हैं, और प्राइवेसी सेंटर की एक्टिविटी रसीद बिना सिंक या एक्सपोर्ट किए 13 रोलिंग महीनों के लिए डिवाइस पर बाउंडेड प्रति-ऐप टोटल रखती है। इंजीनियरिंग के नजरिए से, प्रोजेक्ट XcodeGen, Swift 6 स्ट्रिक्ट कॉन्करेंसी, एक द्विभाषी अंग्रेजी/स्पेनिश String Catalog गेट, एक्सेसिबिलिटी सपोर्ट और एक सिंगल SwiftPM पैकेज (GanchoKit) का उपयोग करता है जिसमें आठ लाइब्रेरी उत्पाद और एक CLI शामिल है। CI में बिल्ड, टेस्ट और लिंट, एक लागू प्रोडक्शन-सोर्स कवरेज फ्लोर, सीरियलाइज्ड StoreKit ऑटोमेशन और स्केल परफॉरमेंस शामिल हैं। बिल्ड करने के लिए macOS 15.4+, Xcode 26+ और XcodeGen की आवश्यकता होती है, जिसमें टेस्ट, iOS डिवाइस इंस्टॉल्स, पैकेजिंग, रिलीज QA और साइट चेक के लिए प्रलेखित make टारगेट हैं। README में GRDB.swift, SQLCipher, KeyboardShortcuts, Sauce और TelemetryDeck को अंतर्निहित ओपन-सोर्स कार्य के रूप में श्रेय दिया गया है। लाइसेंस: MIT, © 2026 Johnny Young।