Skip to content

Messages and Notifications

StormTunnel keeps you informed about tunnel status through in-app toasts and macOS system notifications.

How It Works

  • App active → In-app toast notifications (top-right corner)
  • App in background → macOS system notifications
  • Critical errors → Both toast and system notification

Message Types

Type Icon Auto-Dismiss Use
Critical 🔴 Never Security alerts, system errors
Error ❌ 6 seconds Connection failures
Warning ⚠️ 5 seconds Potential issues
Success ✅ 3 seconds Operations completed
Info ℹ️ 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 appear in macOS Notification Center.

Features:

  • Include tunnel name and severity
  • Persist in Notification Center
  • Respect Do Not Disturb settings
  • Click to return to StormTunnel

Troubleshooting

Toasts Not Appearing

  1. Verify Prefer toasts when app is active is enabled
  2. Make sure app window is visible and focused

System Notifications Not Appearing

  1. Verify Show system notifications is enabled
  2. Check System Settings → Notifications → StormTunnel
  3. Check Do Not Disturb is off

Sounds Not Playing

  1. Enable notification sounds in StormTunnel settings
  2. Check system volume isn't muted
  3. Verify audio output device