Troubleshooting
Troubleshooting
Solve common issues with the z8 Timer desktop app
Having trouble with the z8 Timer? This guide covers common issues and solutions.
Quick Fixes
Before diving deep, try these common solutions:
| Issue | Quick Fix |
|---|---|
| App not responding | Quit and restart from tray |
| Not syncing | Check internet connection |
| Can't sign in | Verify webapp URL is correct |
| Tray icon missing | Check hidden icons / restart app |
| Idle detection not working | Check permissions (macOS) |
Common Issues
Common Issues
Authentication, syncing, and general app problems
Platform-Specific
Windows, macOS, and Linux specific issues
Diagnostic Information
When reporting issues, gather this information:
App Version
- Open Settings
- Find version number at bottom
- Example:
1.0.0
System Information
| Platform | How to Find |
|---|---|
| Windows | Settings → System → About |
| macOS | Apple menu → About This Mac |
| Linux | uname -a in terminal |
Log Files
| Platform | Location |
|---|---|
| Windows | %APPDATA%\com.z8.timer\logs\ |
| macOS | ~/Library/Logs/com.z8.timer/ |
| Linux | ~/.local/share/com.z8.timer/logs/ |
Reset the App
If all else fails, reset to a clean state:
Data Loss
Resetting clears all local data including offline queue and settings. Ensure you're synced first.
Steps to Reset
- Sign out (if possible)
- Quit the app completely
- Delete app data:
Windows:
Remove-Item -Recurse "$env:APPDATA\com.z8.timer"macOS:
rm -rf ~/Library/Application\ Support/com.z8.timerLinux:
rm -rf ~/.config/com.z8.timer- Restart the app
- Reconfigure webapp URL and sign in
Getting Help
If you can't solve the issue:
- Check documentation - Search for your issue
- Collect diagnostics - Version, logs, system info
- Contact support - Through your organization's z8 admin
- Report bugs - If you've found a software bug