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

## यह क्या है Snoop एक ओपन-सोर्स डेस्कटॉप की-माउस गतिविधि रिकॉर्डर है, जो "स्थानीय-प्रथम" के रूप में डिज़ाइन किया गया है: सभी डेटा एक स्थानीय SQLite फ़ाइल में लिखा जाता है, और README में स्पष्ट रूप से कहा गया है कि कोई नेटवर्क अपलोड नहीं होता। यह Windows 10/11 और macOS 10.15+ को सपोर्ट करता है, और इसका ब्रांड Feedra के अंतर्गत है, जिसका मस्कॉट एक बिल्ली है। इसका उद्देश्य कुछ रोजमर्रा के सवालों का जवाब देना है: कौन से ऐप्स सबसे ज्यादा समय ले रहे हैं, दिन के किस समय सबसे ज्यादा गतिविधि होती है, की-माउस की तीव्रता का पैटर्न क्या है, और साप्ताहिक व्यवहार कितना सटीक है। ## गोपनीयता की सीमा (README में स्पष्ट) यह टूल केवल की-माउस की आवृत्ति और तीव्रता को रिकॉर्ड करता है, और निम्नलिखित को नहीं: - विशिष्ट कीस्ट्रोक अनुक्रम (इसलिए पासवर्ड, चैट, या सर्च क्वेरी कैप्चर नहीं होते) - क्लिपबोर्ड, स्क्रीनशॉट, माइक्रोफ़ोन, या कैमरा - कोई भी नेटवर्क-अपलोड योग्य सामग्री डेटाबेस में, एक ऐप के लिए 5-सेकंड की विंडो में "N कीस्ट्रोक्स और X पिक्सेल माउस मूवमेंट" दर्ज होता है। कीबोर्ड हीटमैप प्रत्येक कुंजी के प्रेस काउंट पर आधारित है, बिना अनुक्रम के, इसलिए README के अनुसार, इनपुट को रीकंस्ट्रक्ट नहीं किया जा सकता। ## मुख्य फ़ीचर मॉड्यूल - **ओवरव्यू/आज का स्नैपशॉट**: वर्तमान ऐप और तीव्रता स्तर का कार्ड, दैनिक कुल, ऐप उपयोग समय रैंकिंग, और 24-घंटे की तीव्रता हीट बार。 - **टाइमलाइन**: स्विम लेन गंट चार्ट, प्रत्येक ऐप के लिए एक पंक्ति, समय के साथ रंगीन ब्लॉक; ज़ूम, पैन, और दिनांक चयन को सपोर्ट करता है; 2 घंटे से अधिक के खाली अंतराल को ग्रे ब्लॉक में संकुचित किया जाता है。 - **कीबोर्ड हीटमैप**: वास्तविक कीबोर्ड लेआउट पर रेंडर किया गया, 40/60/68/87/98/104 लेआउट को सपोर्ट करता है; ऐप और समय सीमा के आधार पर फ़िल्टर किया जा सकता है; कीबोर्ड, माउस, और टॉप कीज़ के बीच लिंक किया गया; रंगीन कोड पर्सेंटाइल-आधारित है, ताकि हाई-फ़्रीक्वेंसी कीज़ (जैसे Enter) अन्य को दबा न दें। - **अंतर्दृष्टि/सप्ताह-दर-सप्ताह रिपोर्ट**: साप्ताहिक ट्रेंड बार चार्ट, YOY वृद्धि/घट के साथ ऐप रैंकिंग, और 7×24 व्यवहार हीट ग्रिड। - **अन्य**: ट्रे आइकन, ऑटो-स्टार्ट (डिसेबल किया जा सकता है), डार्क/लाइट थीम, इग्नोर ऐप लिस्ट, बिल्ली के कमेंट्स और "snarkiness" स्तर, और वन-क्लिक डेटा एक्सपोर्ट/क्लीयर। ## इंस्टॉलेशन और रनिंग रिलीज़ से संबंधित प्लेटफ़ॉर्म इंस्टॉलर डाउनलोड करें: - Windows: `Snoop_x.y.z_x64-setup.exe`; SmartScreen को बायपास करने के लिए "More info → Run anyway" चुनें। - macOS Apple Silicon: `Snoop_x.y.z_aarch64.dmg`; macOS Intel: `Snoop_x.y.z_x64.dmg`。 - macOS पर पहली बार चलाने के लिए, "System Settings → Privacy & Security → Accessibility" में अनुमति दें; Gatekeeper को बायपास करने के लिए राइट-क्लिक करके खोलें। ऑटो-अपडेट बिल्ट-इन है: Windows पर, ट्रे मेनू में "Restart to install" दिखाई देता है; macOS पर, डाउनलोड पेज खोलने का प्रॉम्प्ट आता है। ## कार्यान्वयन और प्रदर्शन नोट्स टेक स्टैक: Tauri 2 + React 19 + TypeScript + Vite (frontend), Rust (backend), rusqlite (storage), rdev/Raw Input (capture), और प्लेटफ़ॉर्म-स्पेसिफिक कोड `#[cfg]` से अलग किया गया। UI कस्टम कंपोनेंट्स और CSS vars के साथ डार्क/लाइट थीम को सपोर्ट करता है। README के अनुसार, ग्लोबल मॉनिटरिंग OS-नेটিভ चैनल (Windows पर Raw Input, macOS पर लो-लेवल इवेंट) का उपयोग करती है, और केवल मेमोरी में काउंट करती है, हर 5 सेकंड में बैच करके डेटाबेस में लिखती है। सामान्य CPU उपयोग 1% से कम है। Windows संस्करण लो-लेवल हुक का उपयोग नहीं करता, ताकि EAC/Vanguard के साथ टकराव से बचा जा सके; Snoop किसी DLL को इंजेक्ट नहीं करता, अन्य प्रक्रियाओं की मेमोरी नहीं पढ़ता, और सिमुलेटेड इनपुट नहीं भेजता। डेटा स्थान: Windows पर `%APPDATA%\org.feedra.snoop\`, macOS पर `~/Library/Application Support/org.feedra.snoop/`。 ## स्रोत से बिल्ड करना Node 22+, Rust stable, और प्लेटफ़ॉर्म-स्पेसिफिक टूलचेन की आवश्यकता है। README में नोट किया गया है कि Vite 7 के लिए Node 20.19+/22.12+ की आवश्यकता है; Node 18 का उपयोग करने से `crypto.hash is not a function` की त्रुटि होती है और dev सर्वर नहीं चलता। ```bash npm ci npm run tauri dev # विकास मोड npm run tauri build # इंस्टॉलर पैकेज बनाएं ``` Windows बिल्ड के लिए Visual Studio Build Tools (C++ desktop workload) की आवश्यकता है; macOS के लिए Xcode Command Line Tools की आवश्यकता है। पैकेजिंग और रिलीज़ प्रक्रिया के लिए देखें: `docs/打包与发布.md`。 ## ज्ञात सीमाएं और लाइसेंसिंग वर्तमान में Linux को सपोर्ट नहीं करता, क्योंकि यह प्राथमिक रिलीज़ लक्ष्य नहीं है। मोबाइल या क्लाउड सिंक को सपोर्ट नहीं करता, जिसे डिज़ाइन विकल्प के रूप में वर्णित किया गया है। ब्रांड और कॉपीराइट Feedra (© 2026) के हैं। कोड ओपन-सोर्स है, लेकिन README में कहा गया है कि "Snoop" ब्रांड और मस्कॉट का उपयोग समान उत्पादों के लिए नहीं किया जाना चाहिए। औपचारिक लाइसेंसिंग条款 अभी तक अंतिम रूप नहीं दिए गए हैं; `LICENSE` फ़ाइल को अपडेट किया जाना बाकी है।