Desktop App Troubleshooting

If you're having trouble with the Voltasis desktop app, try these troubleshooting steps. The desktop app is available on the Pro plan.

System tray icon missing

macOS

1. Check System Settings > Control Center > Menu Bar Only for third-party icons.
2. Quit and relaunch the app.
3. If the icon doesn't appear, the menu bar may be full. Close other menu bar apps.

Windows

1. Click the up arrow in the system tray to see hidden icons.
2. Right-click the taskbar > Taskbar Settings > Select which icons appear. Enable Voltasis.
3. If the icon isn't there, quit and relaunch the app.

Linux

1. System tray support depends on your desktop environment.
2. GNOME users may need the AppIndicator extension.
3. KDE Plasma and XFCE support system tray icons natively.

Hotkeys not working

1. Check that hotkeys are enabled in Settings > Hotkeys in the desktop app.
2. Ensure no other application is using the same key combination.
3. Try changing the hotkey to a different combination.
4. On macOS, ensure Voltasis has Accessibility permissions (System Settings > Privacy & Security > Accessibility).

Idle detection not triggering

1. Verify idle detection is enabled in Settings > Timer.
2. Check the idle threshold — set it to at least 5 minutes.
3. Ensure the app is running (check the system tray icon).
4. On macOS, ensure Voltasis has Input Monitoring permissions (System Settings > Privacy & Security > Input Monitoring).

App won't start

1. Try running the app from the command line to see error messages.
2. Delete the app's configuration directory and restart:
   • macOS: ~/Library/Application Support/Voltasis/
   • Windows: %APPDATA%/Voltasis/
   • Linux: ~/.config/Voltasis/
3. Reinstall the app from voltasis.com/download.

Timer shows wrong time

If the desktop timer is out of sync with the web:

1. Check your system clock is correct and set to the right time zone.
2. Force a sync by clicking the sync icon in the system tray menu.
3. Log out and log back in.

Tip: On macOS, grant Voltasis both Accessibility and Input Monitoring permissions for full functionality (hotkeys and idle detection).