Skip to Content
Z8Z8 Docs
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:

  1. Install WebView2 Runtime

    • Download from Microsoft
    • Run the installer
    • Restart z8 Timer
  2. Update WebView2

    • WebView2 updates via Windows Update
    • Check for Windows updates

Tray icon hidden

Symptoms:

  • Icon not visible in system tray

Solutions:

  1. Check overflow area

    • Click the ^ arrow in the system tray
    • z8 Timer may be in the overflow
  2. Pin to taskbar

    • Right-click taskbar → Taskbar settings
    • Find z8 Timer under "System tray icons"
    • Set to "On"
  3. 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:

  1. Check Task Manager

    • Ctrl+Shift+Esc → Startup tab
    • Find z8 Timer
    • Ensure status is "Enabled"
  2. Check Registry

    • Open regedit
    • Navigate to HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
    • Look for z8Timer entry
    • Value should be path to executable
  3. Re-enable in settings

    • Turn off auto-start
    • Save settings
    • Turn on auto-start
    • Save settings

Symptoms:

  • "Open z8 Desktop" does nothing in browser
  • z8:// links don't open the app

Solutions:

  1. Re-register protocol

    • Reinstall the app
    • This re-registers the z8:// handler
  2. Check Registry

    • Open regedit
    • Navigate to HKEY_CLASSES_ROOT\z8
    • Should contain URL handler entries
  3. Set default app

    • Settings → Apps → Default Apps
    • Choose defaults by protocol
    • Find z8 and set to z8 Timer

On this page