This script sets up an automated security check that runs after each wake-up (e.g., unlocking or resuming from sleep). It checks for:
- Suspicious
.plist
files inLaunchAgents
/LaunchDaemons
- Files suggesting keyloggers or monitoring tools
- Apps with Input Monitoring or Accessibility access
- Keyboard-related running processes
- Sends macOS notifications if suspicious items are found
- Uses a whitelist file to ignore known safe entries
- macOS
- Homebrew installed
- Admin password for full scan (some features use
sudo
) - SleepWatcher (
brew install sleepwatcher
) – installed automatically - SQLite (
brew install sqlite
) – installed automatically
You can create a whitelist_items.txt
file in your home directory to suppress alerts from known safe apps, processes, or paths.
Each line should contain a unique keyword or partial path to ignore.
Example:
com.google.keystone
/Library/LaunchAgents/com.adobe.*
GoogleSoftwareUpdate
Run the script provided in install.sh
. It will:
- Install required tools
- Create wake-from-sleep hooks
- Set up the detection script
- Start monitoring automatically
Alerts will appear as native macOS notifications and open logs in TextEdit.