Skip to main content

Notifications

Stay informed about connection status, sync events, security alerts, and important system messages with Xermius's real-time notification system.

Overview​

Xermius provides a comprehensive notification system that keeps you informed about:

  • Connection events: SSH connection success/failure
  • Sync status: Cross-device synchronization updates
  • Security alerts: Important security-related events
  • Account activity: Login detection, password changes, MFA status
  • Device management: New device registrations

All notifications are:

  • Real-time: Delivered instantly
  • Persistent: Stored until you dismiss them
  • Filterable: Filter by type and priority
  • Actionable: Mark as read, delete, or take action
  • Desktop integrated: Optional desktop notifications

Notification Center​

Access:

Top-right corner → Bell icon 🔔

Badge shows unread count:

🔔 3  ← 3 unread notifications

Features:

  • Auto-polling: Checks for new notifications every 30 seconds
  • Unread badge: Shows count of unread notifications (max 9+)
  • Filter options: Filter by type (success, error, warning, info) and priority
  • Bulk actions: Mark all as read, clear all notifications
  • Responsive: Updates in real-time as new notifications arrive

Interface​

┌────────────────────────────────────────┐
│ Notifications              [Filter][✓] │
├────────────────────────────────────────┤
│                                        │
│ ✓ Production Server Connected          │
│   SSH connection established           │
│   2m ago                         [✓][×]│
│                                        │
│ ⚠ Sync Conflict Detected               │
│   Host modified on multiple devices    │
│   5m ago                         [✓][×]│
│                                        │
│ 🔐 Login Detected                      │
│   New login from MacBook Pro           │
│   1h ago                         [✓][×]│
│                                        │
│ ✓ Sync Complete                        │
│   15 hosts synchronized successfully   │
│   3h ago                         [✓][×]│
└────────────────────────────────────────┘

Notification Types​

Xermius supports the following notification types:

Connection Notifications​

Connection Success:

Type: notify_connection_success
Priority: Normal
Icon: ✓ (Green)

✓ Connected to production.example.com
  SSH connection established successfully

Connection Failed:

Type: notify_connection_failed
Priority: High
Icon: ✗ (Red)

✗ Failed to connect to staging.example.com
  Authentication failed - check credentials

Sync Notifications​

Sync Complete:

Type: notify_sync_complete
Priority: Normal
Icon: ✓ (Green)

✓ Sync completed
  25 hosts synchronized successfully

Sync Failed:

Type: notify_sync_failed
Priority: High
Icon: ✗ (Red)

✗ Sync failed
  Unable to reach sync server

Sync Conflict Detected:

Type: notify_sync_conflict_detected
Priority: High
Icon: ⚠ (Yellow)

⚠ Sync conflict detected
  Host "web-01" modified on multiple devices
  Manual resolution required

Sync Conflict Resolved:

Type: notify_sync_conflict_resolved
Priority: Normal
Icon: ✓ (Green)

✓ Sync conflict resolved
  Host "web-01" conflict has been resolved

Auto-Sync Stopped:

Type: notify_auto_sync_stopped
Priority: Urgent
Icon: ⚠ (Red)

⚠ Auto-sync stopped
  Auto-sync stopped due to 3 conflicts
  Please resolve conflicts to continue

Security Notifications​

Security Alert:

Type: notify_security_alert
Priority: Urgent
Icon: 🔒 (Red)

🔒 Security Alert
  Suspicious activity detected on your account

Password Changed:

Type: notify_password_changed
Priority: Normal
Icon: ℹ (Blue)

ℹ Password Changed
  Your account password has been changed

MFA Enabled:

Type: notify_mfa_enabled
Priority: High
Icon: 🔐 (Green)

🔐 Two-Factor Authentication Enabled
  2FA has been enabled for your account

Login Detected:

Type: notify_login_detected
Priority: High
Icon: 🔑 (Yellow)

🔑 Login Detected
  New login from MacBook Pro (192.168.1.100)

Device Notifications​

Device Registered:

Type: notify_device_registered
Priority: Normal
Icon: ℹ (Blue)

ℹ Device Registered
  New device "MacBook Pro" has been registered

Notification Priorities​

Xermius uses a 4-level priority system to help you focus on what matters most:

Urgent Priority 🔴​

Critical issues requiring immediate attention:

Priority: urgent
Examples:
- Security alerts
- Auto-sync stopped
- Critical system failures

Characteristics:

  • Highest priority
  • Cannot be auto-dismissed
  • Desktop notification (if enabled)
  • Stays at top of list

High Priority 🟠​

Important events that need attention:

Priority: high
Examples:
- Connection failures
- Sync conflicts detected
- Login detected
- MFA enabled
- Password changed

Characteristics:

  • Important but not critical
  • Desktop notification (if enabled)
  • Requires acknowledgment

Normal Priority 🟢​

Standard operational notifications:

Priority: normal
Examples:
- Connection success
- Sync complete
- Sync conflict resolved
- Device registered

Characteristics:

  • Regular notifications
  • Can be auto-dismissed
  • Optional desktop notification

Low Priority 🔵​

Informational messages:

Priority: low
Examples:
- Tips and tricks
- Feature announcements
- General information

Characteristics:

  • Lowest priority
  • Auto-dismiss after timeout
  • No desktop notification

Managing Notifications​

Mark as Read​

Single notification:

Click ✓ button → Marked as read
Dot disappears, text lightens

All notifications:

Click "Mark All Read" button
All notifications marked read
Badge count resets to 0

Delete Notifications​

Single:

Click × button → Notification removed
Permanently deleted

Clear all:

Menu (⋯) → "Clear All"
Removes all notifications
Cannot be undone

Filter Notifications​

By type:

Filter → [Type ▼]
☐ Connection
☐ Sync
☐ Updates
☐ System

Select to filter view

By priority:

Filter → [Priority ▼]
☐ High
☐ Medium  
☐ Low

Show only selected priorities

Clear filters:

Active filters: 2
[Clear Filters] button appears
Click to show all

Notification Settings​

Access:

Hosts → Settings → Notifications

Enable/Disable Notification Types​

Xermius allows you to control which notifications you receive. Each notification type can be individually enabled or disabled:

Connection Notifications:
[✓] Connection success
[✓] Connection failed

Sync Notifications:
[✓] Sync complete
[✓] Sync failed
[✓] Sync conflict detected
[✓] Sync conflict resolved
[✓] Auto-sync stopped

Security Notifications:
[✓] Security alerts
[✓] Password changed
[✓] MFA enabled
[✓] Login detected

Device Notifications:
[✓] Device registered

How it works:

  • Preferences are synced across all your devices
  • Disabled notifications won't be shown
  • Changes take effect immediately
  • Desktop notifications respect these settings

Desktop Notifications​

Desktop notifications show system-level alerts even when Xermius is in the background:

Features:

  • Native OS notifications (macOS, Windows, Linux)
  • Configurable per notification type
  • Respects system Do Not Disturb settings
  • Shows notification title, message, and priority

Configuration:

Desktop Notifications:
[✓] Enable desktop notifications

Show for:
[✓] Urgent priority
[✓] High priority
[ ] Normal priority
[ ] Low priority

Example desktop notification:

┌────────────────────────────────┐
│ 🔔 Xermius                     │
├────────────────────────────────┤
│ Connected to Production        │
│                                │
│ SSH connection established     │
│ production.example.com         │
└────────────────────────────────┘

Notification Preferences Sync​

Your notification preferences are automatically synced across all your devices:

  • Cloud storage: Preferences stored in your account
  • Real-time sync: Changes sync immediately
  • Per-device override: Can override on specific devices (future feature)
  • Auto-refresh: App updates preferences automatically

Use Cases​

Monitor Connections​

Stay informed:

Working on multiple servers?
Notification shows:
- When connections established
- When they disconnect
- Any connection errors

Glance at notification center
Know status of all connections

Track Sync Status​

Multi-device setup:

Notifications show:
- Sync completed
- Conflicts detected
- Sync errors

Know your data is up-to-date
Resolve conflicts quickly

Never Miss Updates​

Stay current:

Update available notification
Click to view changes
Install when convenient
Never run outdated version

Critical Alerts​

Security & issues:

High priority notifications:
- Host key changed
- License expired
- Security warnings

Immediate attention needed
Can't miss critical issues

Tips & Best Practices​

1. Check Regularly​

Make it a habit:
- Check notifications daily
- Clear read ones
- Act on important items
- Keep inbox clean

2. Use Filters​

Too many notifications?
Filter by:
- Type (only connections)
- Priority (only high)

Focus on what matters

3. Configure Priorities​

Adjust what's high priority:
- Critical: Connection failures
- Medium: Sync status
- Low: General info

Customize for your workflow

4. Enable Desktop Notifications​

For important events:
[✓] Connection failures
[✓] Sync errors
[✓] Security warnings

[ ] Connection success
[ ] Sync complete
[ ] Tips

Get alerts for critical only

5. Review Before Clearing​

Before "Clear All":
- Scan for important items
- Note any action needed
- Take screenshots if needed

Then clear with confidence

Troubleshooting​

Not Receiving Notifications​

Check settings:

Settings → Notifications
Verify types enabled:
[✓] Connection events
[✓] Sync status
etc.

Check Do Not Disturb:

Settings → Notifications → Do Not Disturb
[ ] Disabled (or outside schedule)

Desktop Notifications Not Showing​

macOS:

System Preferences → Notifications
→ Xermius
[✓] Allow Notifications
[✓] Show in Notification Center

Windows:

Settings → System → Notifications
→ Xermius
[✓] On

Linux:

Depends on desktop environment
Check notification daemon running

Badge Count Wrong​

Reset:

1. Click "Mark All Read"
2. Close notification center
3. Reopen
4. Count should be correct

If not: Restart Xermius

Old Notifications Won't Clear​

Force clear:

Settings → Advanced
→ Reset Notifications
[Clear All Data]

Removes all notifications
Fresh start

Keyboard Shortcuts​

Open Notification Center: Ctrl+Shift+N (Cmd+Shift+N)
Mark All Read: Ctrl+Shift+M (Cmd+Shift+M)
Close Center: Esc
Next Notification: ↓
Previous Notification: ↑
Mark Selected as Read: Space
Delete Selected: Delete/Backspace

Next Steps​