عن المشروع

MacWatcher هي أداة Hammerspoon Spoon لنظام macOS تنفذ أوامر shell استجابة لأحداث النظام. وهي موجهة للمستخدمين الذين يشغلون Hammerspoon بالفعل ويريدون تشغيل سكربتات أو برامج تلقائيًا عند تغير حالة الجهاز. المحفزات المدعومة، كما هو موضح في README: - الاستئناف من النوم أو فتح القفل (whenResume)، مع تأخير اختياري قبل تنفيذ الأمر. - الانتقال إلى النوم أو القفل (whenSuspend)، والذي يمكن تنفيذه مباشرة قبل الحدث. - تغييرات شبكة WiFi (onWifiChange)؛ يتم إلحاق SSID كوسيطة للأمر. - تغييرات المظهر الفاتح/الداكن (onThemeChange)، بما في ذلك التغييرات التي حدثت أثناء نوم الجهاز؛ يتم إلحاق القيمة "light" أو "dark" كوسيطة. - خطاف إيقاف متزامن (whenStop) يتم تشغيله عند استدعاء stop(). تشمل خيارات التكوين فترة تبريد (الحد الأدنى من الثواني بين عمليات تنفيذ الخطاف) ومهلة زمنية للمهمة لتنفيذ الأمر. يتم تنفيذ الأوامر بشكل غير متزامن مع مهلات زمنية، ويقبل كل خطاف معلمة تأخير. مسارات التثبيت المغطاة في README: تنزيل ملف الإصدار المضغوط ووضع مجلد MacWatcher.spoon في ~/.hammerspoon/Spoons/، أو التثبيت عبر SpoonInstall من رابط ملف الإصدار المضغوط، أو استنساخ المستودع مباشرة في دليل Spoons للتطوير. بعد التثبيت، يجب إعادة تحميل Hammerspoon. الاستخدام يتم عبر تكوين Lua: تحميل الأداة باستخدام hs.loadSpoon("MacWatcher")، واختياريًا تعيين cooldown وtaskTimeout، وتسجيل الخطافات بالطرق المتسلسلة الموضحة أعلاه، ثم استدعاء start(). مرجع API الكامل منشور على GitHub Pages. المشروع مرخص بموجب MIT.