Messages and Notifications¶
StormTunnel uses in-app toasts when the window is active and macOS system notifications when it is in the background. Critical errors trigger both.
Message Types¶
| Type | Icon | Auto-Dismiss | Use |
|---|---|---|---|
| Critical | Red | Never | Security alerts, system errors |
| Error | X | 6 seconds | Connection failures |
| Warning | ! | 5 seconds | Potential issues |
| Success | OK | 3 seconds | Operations completed |
| Info | i | 4 seconds | Status updates |
Notification Settings¶
Settings -> General -> Notifications
| Setting | Default | Description |
|---|---|---|
| Prefer toasts when app is active | On | Show in-app toasts instead of system notifications |
| Show system notifications | On | Display notifications when app is in background |
| Always show critical as system notifications | On | Critical alerts always use system notifications |
| Enable notification sounds | Off | Play sounds for notifications |
Toast Notifications¶
Toasts appear in the window corner and auto-dismiss based on severity.
- Main window: Top-right corner
- Menu bar popup: Bottom-center
- Click the close button to dismiss early
- Critical toasts require manual dismissal
System Notifications¶
When StormTunnel is in the background, notifications go to macOS Notification Center.
- Include tunnel name and severity
- Persist in Notification Center
- Respect Do Not Disturb
- Click to bring StormTunnel to front