Troubleshooting
Windows Issues
Windows-specific troubleshooting for the z8 Timer desktop app
WebView2 missing or outdated
Symptoms:
- App won't start
- Blank white window
- "WebView2 Runtime not found" error
Solutions:
-
Install WebView2 Runtime
- Download from Microsoft
- Run the installer
- Restart z8 Timer
-
Update WebView2
- WebView2 updates via Windows Update
- Check for Windows updates
Tray icon hidden
Symptoms:
- Icon not visible in system tray
Solutions:
-
Check overflow area
- Click the
^arrow in the system tray - z8 Timer may be in the overflow
- Click the
-
Pin to taskbar
- Right-click taskbar → Taskbar settings
- Find z8 Timer under "System tray icons"
- Set to "On"
-
Restart Explorer
Stop-Process -Name explorer -Force; Start-Process explorer
Auto-start not working
Symptoms:
- App doesn't start on login
- Setting enabled but doesn't work
Solutions:
-
Check Task Manager
- Ctrl+Shift+Esc → Startup tab
- Find z8 Timer
- Ensure status is "Enabled"
-
Check Registry
- Open
regedit - Navigate to
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run - Look for
z8Timerentry - Value should be path to executable
- Open
-
Re-enable in settings
- Turn off auto-start
- Save settings
- Turn on auto-start
- Save settings
Deep link not working
Symptoms:
- "Open z8 Desktop" does nothing in browser
z8://links don't open the app
Solutions:
-
Re-register protocol
- Reinstall the app
- This re-registers the
z8://handler
-
Check Registry
- Open
regedit - Navigate to
HKEY_CLASSES_ROOT\z8 - Should contain URL handler entries
- Open
-
Set default app
- Settings → Apps → Default Apps
- Choose defaults by protocol
- Find
z8and set to z8 Timer