Installation

Download

Download the z8 Timer installer for your platform from your organization's Z8 portal or the official download page.

Platform	Format	Download
Windows	`.msi` installer	Contact your admin
Windows	`.exe` installer	Contact your admin
macOS	`.dmg` disk image	Contact your admin
Linux	`.deb` package	Contact your admin
Linux	`.AppImage`	Contact your admin

Installation Instructions

Windows Installation

Download the installer

Download the .msi or .exe file from your organization's portal

Run the installer

Double-click the downloaded file. If prompted by Windows Defender SmartScreen, click "More info" → "Run anyway"

Follow the wizard

Accept the license agreement and choose installation location (default is recommended)

Launch the app

z8 Timer will appear in your system tray after installation. Look for the gray clock icon near your clock.

WebView2 Runtime

Windows 10 users may be prompted to install the WebView2 Runtime. This is required and will be installed automatically.

Windows Auto-Update

The app checks for updates automatically. When an update is available, you'll be prompted to install it.

macOS Installation

Download the DMG

Download the .dmg file from your organization's portal

Open the DMG

Double-click the downloaded .dmg file to mount it

Drag to Applications

Drag the z8 Timer icon to the Applications folder shortcut

Launch the app

Open z8 Timer from your Applications folder or Launchpad

Grant permissions

When prompted, allow:

Accessibility - For idle detection (keyboard/mouse monitoring)
Notifications - For clock reminders

First Launch

On first launch, macOS may show "z8 Timer cannot be opened because Apple cannot check it for malicious software."

To open: Right-click the app → Open → Click "Open" in the dialog.

macOS Permissions

For full functionality, grant these permissions in System Preferences → Security & Privacy → Privacy:

Permission	Purpose
Accessibility	Idle detection (input monitoring)
Notifications	Clock reminders

Linux Installation

Debian/Ubuntu (.deb)

# Download and install
sudo dpkg -i z8-timer_*.deb

# Fix any missing dependencies
sudo apt-get install -f

AppImage

# Make executable
chmod +x Z8-Timer-*.AppImage

# Run
./Z8-Timer-*.AppImage

AppImage Integration

For desktop integration (menu entry, icons), use AppImageLauncher.

Arch Linux (AUR)

yay -S z8-timer-bin

Linux Dependencies

Ensure you have:

# Debian/Ubuntu
sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0

# Fedora
sudo dnf install webkit2gtk4.1 gtk3

# Arch
sudo pacman -S webkit2gtk-4.1 gtk3

Post-Installation

After installation:

Find the app - Look for z8 Timer in your system tray (Windows/Linux) or menu bar (macOS)
Configure server - Click the tray icon → Settings → Enter your webapp URL
Sign in - Authenticate with your Z8 account

Verifying Installation

Check that the app is working correctly:

Check	Expected
Tray icon visible	Gray clock icon in system tray
App launches	Main window opens on click
Settings accessible	Can open settings dialog
Browser opens	"Sign in" opens your browser

Uninstallation

Open Settings → Apps → Installed Apps
Find "z8 Timer"
Click Uninstall

Open Finder → Applications
Drag z8 Timer to Trash
Empty Trash

To remove settings:

rm -rf ~/Library/Application\ Support/com.z8.timer

Debian/Ubuntu:

sudo apt remove z8-timer

AppImage: Simply delete the AppImage file

To remove settings:

rm -rf ~/.config/com.z8.timer

Installation

On this page