Alerts & actions

Alerts keep you informed automatically. Instead of watching the dashboard every second, you set up rules that watch for you — and when something happens, ShowTrak reacts the way you told it to.

An alert rule has three parts:

1. What to watch — which clients, groups, or targets the rule applies to.
2. The trigger — the event that fires the rule, such as a client going offline.
3. One or more actions — what happens when it fires, such as playing a sound, posting to Discord, or sending an OSC message.

Opening the Alerts area

• Click the Alerts button (the warning‑triangle icon) in the top‑right, or
• Use the + menu and choose Manage Alerts or Create Alert.

When alerts fire, they also appear in the Alerts tray with a colour‑coded severity, a short message, and how long ago they happened. A badge on the Alerts button shows how many are unread, and you can dismiss them individually or all at once.

Turning alerts on and off

The ALERTS button in the bottom bar turns alert actions on or off globally. When it's off, events are still recorded but actions (sounds, webhooks, and so on) don't run — handy when you're setting things up or rehearsing.

Creating an alert rule

1. Switch to Edit mode.
2. Open Create Alert from the + menu.
3. Rule Title — give the rule a clear name, e.g. "Front‑of‑house PC offline".
4. Select targets — choose what to watch. You can pick All Clients, whole groups, or individual clients, dummy clients, and monitoring targets.
5. Trigger — choose the event that should fire the rule (see the list below).
6. Add Action — add one or more actions and configure each one (see Alert actions below). You can add several; they all run when the rule fires.
7. Click Save. The rule is active immediately.

Editing or deleting a rule

• Open Manage Alerts, click a rule to open it, change anything you like, then Save.
• To remove a rule, open it and click Delete.
• To remove a single action from a rule, open the action and choose Delete Action.

Available triggers

Alert actions

Each rule can run one or more of these actions when it fires:

Create ShowTrak Alert

Raises an alert inside ShowTrak — it appears in the Alerts tray and as a brief on‑screen notification. Optionally give it a custom title; otherwise a description is generated for you. Great for things you want the operator to see right away.

Play Alert Sound

Plays one of the built‑in sounds on the Server machine: Notification, Alert, or Warning. Use the preview button to hear them while you choose.

Play Custom Audio Asset

Plays one of your own imported sound files (see Custom audio files below). Pick the asset from the dropdown and preview it. If the chosen file is ever removed, the action falls back to a built‑in notification sound and shows a warning.

OSC Trigger

Sends an OSC message to another device or application — for example a lighting console or media server. You set the target IP/hostname, port (default 3333), and the message path (default /API/Alert). The path can include live values from the event, such as {{entityName}}, {{triggerType}}, {{severity}}, {{ip}}, {{uuid}}, and {{groupId}}.

HTTP/S API

Sends the alert to a web address as a JSON message. You choose http or https, the target, port, route, and method (usually POST). The message includes the trigger type, the device name, its IP, severity, and more — useful for hooking ShowTrak into your own tools or automations.

Discord Webhook

Posts a tidy, colour‑coded message to a Discord channel using a webhook URL you provide. The colour reflects the severity (red for critical, orange for warning, green for good news). Perfect for keeping a team channel informed.

Custom audio files

Custom audio lets your Play Custom Audio Asset actions use your own sounds. These are shared across the whole app, so you set them up once.

Importing audio

1. Open the Alerts area and click Audio Assets.
2. Click Select Files and choose one or more audio files.
3. Each file is checked and added to the list.

Supported formats: MP3, WAV, OGG, M4A, AAC, FLAC, and Opus. Limits: up to 15 MB and 15 seconds per file. Anything larger or longer is rejected with a reason.

Managing audio

Each imported sound has:

• A label you can rename (letters and numbers only).
• A read‑only line showing its format, size, and length.
• A volume slider that applies whenever that sound plays.
• A preview button to hear it at the set volume.
• A delete button to remove it.

If you delete a sound that a rule still uses, that action shows it as missing and falls back to a built‑in notification sound until you pick a new one.