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 --diagnostics

This 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:

  1. Navigate to your storage directory (default: ~/Pictures/.access)
  2. Browse through the directory structure to find the most recent log file
  3. Each wake event creates a monitor.log file in its directory
  4. You can view the log file using any text editor or with the cat command:
    cat ~/Pictures/.access/YEAR/MONTH/DAY/TIME/monitor.log

Reinstalling Mac Watcher

If you're experiencing persistent issues, you can try reinstalling Mac Watcher:

  1. Uninstall Mac Watcher:
    brew uninstall ramanaraj7/tap/mac-watcher
  2. Remove configuration files:
    rm -f ~/.wakeup ~/.config/monitor.conf
  3. Reinstall Mac Watcher:
    brew install ramanaraj7/tap/mac-watcher
  4. Run the setup again:
    mac-watcher --setup
  5. 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.