Skip to Content
Z8Z8 Docs
Features

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:

IconStateMeaning
Gray clockNot clocked inReady to start tracking
Green clockClocked inCurrently 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                │
└─────────────────────┘
ActionDescription
Show WindowOpens the main app window
SettingsOpens settings dialog directly
QuitCompletely closes the app

Click Behavior

ClickAction
Left-clickShow main window
Right-clickOpen context menu

Minimizing to Tray

The app is designed to live in the tray:

  1. Close button - Minimizes to tray (doesn't quit)
  2. Minimize button - Minimizes to tray
  3. 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:

  1. Right-click the tray icon
  2. Select Quit

Always-on-Top

The app window can stay above other windows:

  1. Open Settings
  2. Enable Always on Top
  3. 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:

  1. Click the ^ arrow in the system tray
  2. Look for z8 Timer in the overflow area
  3. Drag it to the main tray area for quick access

Pin to Taskbar

  1. Right-click the overflow arrow (^)
  2. Select Taskbar settings
  3. Under "System tray icons", find z8 Timer
  4. 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:

MetricUsage
Memory~5 MB
CPU0% when idle
GPUNone

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.

On this page