System Tray
System tray integration in the z8 Timer desktop app
The z8 Timer lives in your system tray for always-available access without cluttering your desktop.
Tray Icon Location
The tray icon appears in the Windows system tray (bottom-right, near the clock).
Icon States
The tray icon changes color to indicate your clock status:
| Icon | State | Meaning |
|---|---|---|
| Gray clock | Not clocked in | Ready to start tracking |
| Green clock | Clocked in | Currently tracking time |
This gives you instant visibility of your work status without opening the app.
Tray Menu
Right-click the tray icon to see the context menu:
┌─────────────────────┐
│ Show Window │
│ Settings │
│ ────────────────── │
│ Quit │
└─────────────────────┘Menu Actions
| Action | Description |
|---|---|
| Show Window | Opens the main app window |
| Settings | Opens settings dialog directly |
| Quit | Completely closes the app |
Click Behavior
| Click | Action |
|---|---|
| Left-click | Show main window |
| Right-click | Open context menu |
Minimizing to Tray
The app is designed to live in the tray:
- Close button - Minimizes to tray (doesn't quit)
- Minimize button - Minimizes to tray
- Tray click - Brings window back
Always Running
Even when the window is closed, the app continues running in the tray. Idle detection and offline sync continue working.
Quitting the App
To actually close the app:
- Right-click the tray icon
- Select Quit
Always-on-Top
The app window can stay above other windows:
- Open Settings
- Enable Always on Top
- The window will stay visible above other applications
Useful for:
- Quick clock in/out while working
- Seeing elapsed time while you work
- Keeping the app accessible
You can still minimize to tray even with always-on-top enabled.
Hidden Icon
If you can't see the tray icon:
- Click the ^ arrow in the system tray
- Look for z8 Timer in the overflow area
- Drag it to the main tray area for quick access
Pin to Taskbar
- Right-click the overflow arrow (^)
- Select Taskbar settings
- Under "System tray icons", find z8 Timer
- Enable On
Tray Icon Not Showing
- Check the overflow area (^ arrow)
- Restart Windows Explorer:
taskkill /f /im explorer.exe && start explorer
Resource Usage
The tray component is lightweight:
| Metric | Usage |
|---|---|
| Memory | ~5 MB |
| CPU | 0% when idle |
| GPU | None |
The icon only redraws when status changes (clock in/out).
Customization
Currently, the tray icon style is not customizable. It uses:
- Gray clock icon for "not clocked in"
- Green clock icon for "clocked in"
Future versions may support custom icons or themes.