Troubleshooting Guide
Solutions to common issues and problems with Mac Watcher.
Diagnostics
Mac Watcher includes a diagnostics tool to help identify and resolve issues. To run diagnostics:
mac-watcher --diagnosticsThis will check all components and dependencies to ensure everything is working properly.
Common Issues
Checking Logs
Mac Watcher creates log files that can help diagnose issues. To view the logs:
- Navigate to your storage directory (default:
~/Pictures/.access) - Browse through the directory structure to find the most recent log file
- Each wake event creates a
monitor.logfile in its directory - You can view the log file using any text editor or with the
catcommand:cat ~/Pictures/.access/YEAR/MONTH/DAY/TIME/monitor.log
Reinstalling Mac Watcher
If you're experiencing persistent issues, you can try reinstalling Mac Watcher:
- Uninstall Mac Watcher:
brew uninstall ramanaraj7/tap/mac-watcher - Remove configuration files:
rm -f ~/.wakeup ~/.config/monitor.conf - Reinstall Mac Watcher:
brew install ramanaraj7/tap/mac-watcher - Run the setup again:
mac-watcher --setup - Configure Mac Watcher:
mac-watcher --config
Getting Help
If you're still experiencing issues with Mac Watcher, you can:
- Check the GitHub repository: Visit the Mac Watcher GitHub repository for the latest information and updates.
- Open an issue: If you've found a bug or have a feature request, you can open an issue on GitHub.
- Contact the developer: You can reach out to the developer through the contact information provided in the GitHub repository.