Whozz Calling Installation Guide

Print / Save PDF

Whozz Calling Installation Guide

Version 2.3.2 - January 2026

This guide explains how to build and install the Whozz Calling Desktop Application on Windows workstations. Follow these steps to update existing installations or set up new computers.

Part 1: Build the Executable (One Time Setup)

Complete these steps on ONE computer. You'll then copy the resulting file to all workstations.

1 ## Download the Application Files

Create a folder on your computer: C:\WhozzCallingBuild\

Open your web browser and go to your Whozz Calling web app

Click on Documentation Index

Download these files to your folder: whozz_calling_tray_v2.2.py (the main program)

zeus.png (the tray icon)

zeus.ico (optional - Windows icon)

2 ## Install Python

Go to: https://www.python.org/downloads/

Download Python 3.12 or newer

Run the installer

IMPORTANT: Check the box that says "Add Python to PATH" before clicking Install!

Click "Install Now" and wait for completion

3 ## Install Required Packages

Press Windows Key + R on your keyboard

Type cmd and press Enter

In the black command window, type this command and press Enter:

pip install pystray pillow pyserial keyring pyinstaller Wait for all packages to download and install (may take 1-2 minutes).

4 ## Build the Executable

In the same command window, navigate to your folder:

cd C:\WhozzCallingBuild Run this command to build the .exe file:

python -m PyInstaller --onefile --noconsole --icon=zeus.ico whozz_calling_tray_v2.2.py If you don't have zeus.ico, use this command instead:

python -m PyInstaller --onefile --noconsole whozz_calling_tray_v2.2.py Wait 1-2 minutes for the build to complete

When finished, you'll see "Building completed successfully"

5 ## Find Your New Executable

Open File Explorer

Navigate to: C:\WhozzCallingBuild\dist\

You'll find whozz_calling_tray_v2.2.exe

Success! This is your new application file. You'll copy this to each workstation.

Part 2: Install on Each Workstation

Repeat these steps for every computer that needs the Whozz Calling application.

6 ## Copy Files to Workstation

Copy these three files to each workstation (use USB drive, network share, or email):

File Description Required?

whozz_calling_tray_v2.2.exe The main application Yes

zeus.png Tray icon image Yes

config.txt Configuration with API key Yes

Place all files in the same folder, for example: C:\WhozzCalling\

7 ## Create Configuration File

Create a file named config.txt in the same folder with this content:

API_KEY=your-api-key-here REDACT_LOGS=true Replace your-api-key-here with your actual API key from the web dashboard.

8 ## Run the Application

Double-click whozz_calling_tray_v2.2.exe

Look for the phone icon in your system tray (bottom-right of screen)

Right-click the icon to see the menu

9 ## Enable Auto-Start (Optional)

Right-click the tray icon

Click "Start with Windows" to enable it

A checkmark will appear when enabled

The application will now start automatically when the computer boots up.

Quick Reference Checklist

Print this page and check off items as you complete each workstation:

Workstation: _______________________

Copy whozz_calling_tray_v2.2.exe to workstation

Copy zeus.png to same folder

Create/copy config.txt with API key

Double-click .exe to test - icon appears in tray

Enable "Start with Windows" from tray menu

Test: Make a call and verify popup appears

Workstation: _______________________

Copy whozz_calling_tray_v2.2.exe to workstation

Copy zeus.png to same folder

Create/copy config.txt with API key

Double-click .exe to test - icon appears in tray

Enable "Start with Windows" from tray menu

Test: Make a call and verify popup appears

Workstation: _______________________

Copy whozz_calling_tray_v2.2.exe to workstation

Copy zeus.png to same folder

Create/copy config.txt with API key

Double-click .exe to test - icon appears in tray

Enable "Start with Windows" from tray menu

Test: Make a call and verify popup appears

Troubleshooting

Problem Solution

Application won't start Make sure config.txt and zeus.png are in the same folder as the .exe

No popup when call comes in Verify the Whozz Calling device is sending to the correct IP address

Antivirus blocks the app Add the application folder to your antivirus exclusion list

"pip" not recognized Reinstall Python and check "Add Python to PATH"

CallerID.com

Whozz Calling Installation Guide v2.3.2 | January 2026

This document is proprietary and confidential.