Troubleshooting Common Issues
Client Won't Start
Windows
- Check if Monwurx is already running in the system tray
- Right-click the installer and select "Run as Administrator"
- Temporarily disable antivirus and try again
- Reinstall from the official download page
Mac
- Go to System Preferences → Security & Privacy
- Click "Open Anyway" if Monwurx was blocked
- Grant accessibility permissions when prompted
- Restart the application
Tray Icon Missing
- Windows: Click the up arrow (^) in the system tray to show hidden icons. Drag the Monwurx icon to the visible area.
- Mac: Check if the menu bar is full. Some apps may be hidden by the notch on newer MacBooks.
- Linux: Install a system tray extension for your desktop environment (GNOME users need "AppIndicator Support").
Not Syncing Data
If your activity isn't appearing in the dashboard:
- Check your internet connection
- Look for the tray icon color - red means offline
- Right-click tray icon → "Force Sync Now"
- Check Settings → Network for proxy issues
- Restart the desktop client
Tip: Data collected while offline will automatically sync when your connection is restored.
High CPU/Memory Usage
If Monwurx is using too many system resources:
- Lower the screenshot quality in Settings
- Increase the screenshot interval
- Clear the local cache (Settings → Advanced)
- Ensure you're running the latest version
Screenshots Not Capturing
Possible causes and solutions:
| Cause | Solution |
|---|---|
| Privacy mode active | Check tray icon - yellow means privacy mode is on |
| Screen permissions (Mac) | Grant Screen Recording permission in System Preferences |
| DRM protected content | Some applications block screenshots automatically |
| Admin disabled screenshots | Contact your administrator |
Login Issues
- Forgot password: Use "Forgot Password" on the login page
- Activation code not working: Check for typos, or request a new code from your admin
- Account locked: Wait 15 minutes or contact your admin to unlock
Collecting Diagnostic Logs
If you need to contact support, collect logs first:
- Right-click tray icon → Settings → Advanced
- Set Log Level to "Debug"
- Reproduce the issue
- Click "Export Logs" to create a zip file
- Attach the logs to your support request
Privacy: Logs may contain file paths and application names. Review before sharing if concerned.