প্রকল্প সম্পর্কে

## এটি কী Snoop একটি ওপেন-সোর্স ডেস্কটপ কীবোর্ড-মাউস অ্যাক্টিভিটি রেকর্ডিং টুল, যার অবস্থান "লোকাল-ফার্স্ট": সব ডেটা লোকাল একটি SQLite ফাইলে লেখা হয়, README স্পষ্টভাবে বলেছে নেটওয়ার্কে আপলোড হয় না। Windows 10/11 এবং macOS 10.15+ সমর্থিত, ব্র্যান্ড Feedra-এর, মাসকট একটি বিড়াল। এর লক্ষ্য কয়েকটি দৈনন্দিন প্রশ্নের উত্তর দেওয়া: কোন অ্যাপগুলো সবচেয়ে বেশি সময় নিচ্ছে, দিনের কোন সময়ে সবচেয়ে সক্রিয়, কীবোর্ড-মাউস তীব্রতার কার্ভ কীভাবে বদলায়, এক সপ্তাহের রুটিন ও ব্যক্তিগত অনুভূতির মধ্যে কত পার্থক্য। ## গোপনীয়তার সীমা (README-তে স্পষ্ট ঘোষণা) টুল শুধু কীবোর্ড-মাউসের ফ্রিকোয়েন্সি ও তীব্রতা রেকর্ড করে, রেকর্ড করে না: - নির্দিষ্ট কী-ভ্যালু সিকোয়েন্স (তাই পাসওয়ার্ড, চ্যাট কনটেন্ট, সার্চ শব্দ ধরা পড়ে না) - ক্লিপবোর্ড, স্ক্রিনশট, মাইক্রোফোন, ক্যামেরা - নেটওয়ার্কে আপলোড প্রয়োজন এমন কোনো কিছু ডেটাবেসে গ্রানুলারিটি হলো "কোনো অ্যাপ কোনো ৫ সেকেন্ডের স্লটে N বার কী চাপা হয়েছে, মাউস কত পিক্সেল সরেছে"। কীবোর্ড হিটম্যাপ প্রতিটি কী-পজিশনের চাপার সংখ্যার ডি-সিরিয়ালাইজড কাউন্টের উপর ভিত্তি করে, README অনুযায়ী ইনপুট কনটেন্ট পুনর্গঠন করা সম্ভব নয়। ## প্রধান ফিচার মডিউল - **ওভারভিউ / আজকের স্ন্যাপশট**: বর্তমান অ্যাপ ও তীব্রতা স্তরের স্ট্যাটাস কার্ড, দিনের সংখ্যাসূচক সারসংক্ষেপ, অ্যাপ ব্যবহারের সময়ের র‍্যাঙ্কিং, ২৪ ঘণ্টার স্লট তীব্রতা হিট বার। - **টাইমলাইন**: সাঁতার-লেন গ্যান্ট চার্ট, প্রতিটি অ্যাপ এক লাইন, অনুভূমিক অক্ষ সময়, রঙের ব্লক অ্যাপ অনুযায়ী নির্দিষ্ট রঙ; স্ক্রল জুম, ড্র্যাগ প্যান, তারিখ পরিবর্তন সমর্থিত; ২ ঘণ্টার বেশি ফাঁকা ব্যবধান ধূসর ব্লকে সংকুচিত হয়। - **কীবোর্ড হিটম্যাপ**: প্রকৃত কীবোর্ড লেআউটে রেন্ডার, অন্তর্নির্মিত 40/60/68/87/98/104 ইত্যাদি একাধিক লেআউট পরিবর্তনযোগ্য; অ্যাপ ও সময় অনুযায়ী ফিল্টার; কীবোর্ড, মাউস, Top কী তিনটি ব্লক সংযুক্ত; রঙে কোয়ান্টাইল স্তর ব্যবহার, যাতে উচ্চ-ফ্রিকোয়েন্সি কী (যেমন Enter) অন্য কীগুলোকে চাপা না দেয়। - **ইনসাইট / সাপ্তাহিক রিপোর্ট**: সাপ্তাহিক ট্রেন্ড বার চার্ট, পূর্ববর্তী সময়ের তুলনায় উত্থান-পতনসহ অ্যাপ র‍্যাঙ্কিং, 7×24 রুটিন হিট গ্রিড। - **অন্যান্য**: ট্রেতে সর্বদা উপস্থিত, বুটে অটো-স্টার্ট (বন্ধ করা যায়), লাইট/ডার্ক থিম, উপেক্ষিত অ্যাপের তালিকা, বিড়ালের খোঁচা চালু/বন্ধ ও ঝাঁঝের মাত্রা নিয়ন্ত্রণ, এক ক্লিকে ডেটা এক্সপোর্ট ও মুছে ফেলা। ## ইনস্টল ও চালানো Releases থেকে সংশ্লিষ্ট প্ল্যাটফর্মের ইনস্টলার ডাউনলোড করুন: - Windows: `Snoop_x.y.z_x64-setup.exe`; SmartScreen ব্লক করলে "আরও তথ্য → তবুও চালান" নির্বাচন করুন। - macOS Apple Silicon: `Snoop_x.y.z_aarch64.dmg`; macOS Intel: `Snoop_x.y.z_x64.dmg`। - macOS প্রথমবার চালাতে "সিস্টেম সেটিংস → গোপনীয়তা ও নিরাপত্তা → অ্যাক্সেসিবিলিটি"-তে অনুমতি দিতে হবে, গ্লোবাল কীবোর্ড-মাউস মনিটরিংয়ের জন্য; Gatekeeper প্রথমবার ব্লক করলে রাইট-ক্লিক করে খুলুন। অটো-আপডেট অন্তর্নির্মিত: Windows-এ ব্যাকগ্রাউন্ডে ডাউনলোডের পর ট্রে মেনুতে "পুনরায় চালু করে ইনস্টল" জানায়, macOS-এ ডাউনলোড পেজ খুলে ম্যানুয়ালি ওভাররাইট করার নির্দেশ দেয়। ## বাস্তবায়ন ও পারফরম্যান্স বিবরণ টেক স্ট্যাক Tauri 2 + React 19 + TypeScript + Vite (ফ্রন্টএন্ড), Rust ব্যাকএন্ড, rusqlite স্টোরেজ, rdev/Raw Input সংগ্রহ, প্ল্যাটফর্ম-নির্দিষ্ট কোড `#[cfg]` দিয়ে বিচ্ছিন্ন। UI স্বনির্মিত কম্পোনেন্ট ও সেমান্টিক CSS ভেরিয়েবল দিয়ে লাইট/ডার্ক দ্বৈত থিম। README অনুযায়ী গ্লোবাল মনিটরিং অপারেটিং সিস্টেমের নেটিভ চ্যানেল দিয়ে যায় (Windows-এ Raw Input, macOS-এ নিম্ন-স্তরের ইভেন্ট চ্যানেল), ইভেন্ট কলব্যাক শুধু মেমোরিতে কাউন্ট করে, প্রতি ৫ সেকেন্ডে ব্যাচে ডেটাবেসে লেখে, দৈনন্দিন CPU ব্যবহার ১%-এর নিচে। Windows সংস্করণে সচেতনভাবে low-level hook ব্যবহার করা হয়নি, 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` দেখা দেয় এবং ডেভ সার্ভার চালু হয় না। ```bash npm ci npm run tauri dev # ডেভ মোড npm run tauri build # ইনস্টলার তৈরি ``` Windows বিল্ডে Visual Studio Build Tools (C++ ডেস্কটপ ডেভেলপমেন্ট ওয়ার্কলোড) দরকার, macOS বিল্ডে Xcode Command Line Tools দরকার। প্যাকেজিং ও রিলিজ প্রক্রিয়া রিপোজিটরির `docs/打包与发布.md`-তে দেখুন। ## পরিচিত সীমাবদ্ধতা ও লাইসেন্স Linux এখনো সমর্থিত নয়, README বলেছে এটি বর্তমান রিলিজ লক্ষ্য নয়। ফোন বা ক্লাউডে সিঙ্ক সমর্থিত নয়, লেখক এটিকে ডিজাইন সিদ্ধান্ত হিসেবে বর্ণনা করেছেন। ব্র্যান্ড ও কপিরাইট Feedra-এর (© 2026)। কোড ওপেন-সোর্স, তবে README চায় "Snoop" ব্র্যান্ড ও মাসকট সমজাতীয় পণ্যে ব্যবহার না করতে। আনুষ্ঠানিক লাইসেন্স শর্ত এখনো নির্ধারিত হয়নি, `LICENSE` ফাইল যোগ করা বাকি।