Customizing Agent Tray Icons and Alert Sounds (Windows & macOS)
DeskAlerts 12 is currently under active development and is not production-ready.
This version is available for testing purposes only.
To request access, please contact DeskAlerts Support team.
Overview
Starting with DeskAlerts 12, the agent application supports basic customization of tray icons and alert sounds on both Windows and macOS.
This is the first stage of the customization feature. At this stage, customization is performed locally on the client side by placing specific files into a dedicated folder.
How It Works
The DeskAlerts Agent app checks for a special folder named Customization at startup.
- If the folder exists and contains supported files, the agent uses them instead of the default embedded assets.
- If a file is missing, the agent falls back to a default option.
This behavior has been verified on Windows and macOS. After placing the folder and restarting the Agent app, customization is applied automatically.
Supported Files
Tray Icons
The Customization folder can include up to three tray icon files:
- logo-green.ico
- logo-red.ico
- logo-orange.ico
These icons correspond to different agent states and must be named exactly as shown.
Alert Sounds
You can override alert sounds for specific alert types by adding .wav files with the following names:
- notify.wav
- notify-emergency.wav
- notify-ticker.wav
- notify-videoalert.wav
- notify-surveyquiz.wav
- notify-surveypoll.wav
- notify-simplesurvey.wav
- notify-rsvp.wav
Fallback Logic
- If a specific sound file (for example,
notify-rsvp.wav) is missing, the client usesnotify.wav. - If
notify.wavis also missing, the Agent app falls back to the default sound embedded in the application.
This mechanism ensures that alerts always play a sound, even if customization is incomplete.
Maximum length is 3 seconds. If a sound file is longer than 3 seconds, it will be automatically trimmed.
An example archive is available: Customizations.zip.