Skip to content
← Documentation

Notifications

Notifications

CyberSnap uses toast notifications to keep you informed about events and actions without interrupting your workflow. Notifications appear as non-intrusive popups on your screen.


Notification Types

Capture Notifications

Event Content Actions
Capture successful Thumbnail preview of the capture Edit, Copy, Share, Open
Recording complete Duration and file size Open, Open folder, Trim
Upload complete Uploaded image preview and URL Copy URL, Open in browser
Upload failed Error message and reason Retry, View settings
OCR complete Extracted text preview Copy, Translate, Search
Scroll capture progress Pages captured and stitching status Cancel, Preview

System Notifications

Event Content Actions
Update available Version number and changelog link Download, Dismiss, Later
Achievement unlocked Achievement name and description View achievements
Hotkey conflict Conflicting hotkey and application Resolve, Ignore
Storage limit reached Current usage and limit Open settings, Clear history

Error Notifications

Event Content Actions
Capture failed Error description Retry, Report
Upload timeout Provider and duration Retry, Change settings
OCR failed Failure reason Retry, Change language
Save failed File path and error Retry, Choose location

Notification Settings

General

Setting Description
Enable notifications Master toggle for all notifications
System notifications Brief text-only status messages

Appearance

Setting Description
Position Screen corner for notifications
Duration How long notifications stay visible (1–30 seconds)
Fade animation Fade in/out effect duration
Maximum on screen Limit simultaneous notifications
Show thumbnail Include image preview in notifications

Behavior

Setting Description
Click action What happens when clicking the notification body
Auto-dismiss Automatically hide after duration
Persistent mode Require manual dismissal
Sound Play sound with notifications
Action buttons Show action buttons on notifications

Quiet Hours

Quiet hours suppresses non-error notifications during a configurable time window. Error alerts still appear.

How It Works

  • When quiet hours is active, all non-error toasts are muted
  • Critical error alerts still display normally
  • Capture previews and status messages stay silent
  • Test notification buttons bypass quiet hours

Configuration

  1. Go to Settings → Notifications
  2. Enable Quiet hours
  3. Set From time (start of quiet window)
  4. Set To time (end of quiet window)

Schedule

  • Times are selected in 30-minute increments (e.g., 22:00, 22:30, 23:00)
  • Supports overnight ranges (e.g., 22:00–07:00)
  • Based on local system time

Default Values

Setting Default
Start 22:00
End 07:00

Status Display

The settings page shows dynamic status:

  • "Active now — only critical alerts until {end}" — when quiet hours is currently active
  • "Starts at {start}" — when quiet hours is inactive

Bypass

The following bypass quiet hours:

  • Error notifications (always shown)
  • Test notification buttons in settings (for previewing toast appearance)

Notification Position

Choose where notifications appear on screen:

Position Description
Top-right Default position, below taskbar
Top-left Top-left corner of primary monitor
Bottom-right Above taskbar (Windows default)
Bottom-left Bottom-left corner
Center Center of the screen

For multi-monitor setups, notifications appear on the primary monitor by default, or you can specify a target monitor.


Action Buttons

Notifications can include configurable action buttons for quick responses:

Available Buttons

Button Action
Save Save capture to configured folder
Copy Copy image to clipboard
Edit Open capture in annotation editor
Share Upload to default provider
History Open capture in gallery
Delete Delete the capture file
Pin Pin preview to prevent auto-dismiss
Close Dismiss the notification

Button Layouts

Preset Description
Minimal Essential buttons only
Standard Common actions
Full All available buttons
None No overlay buttons — relies on body click action

Button Positioning

Each button can be assigned to one of 8 positions around the notification:

  • Top-left, top-inner-left, top-inner-right, top-right
  • Bottom-left, bottom-inner-left, bottom-inner-right, bottom-right

Notification History

CyberSnap maintains a notification history:

  • Access via the Gallery or system tray
  • View past notifications you may have missed
  • Clear history or configure retention

Custom Sounds

Assign custom sounds to notification events:

Event Default Sound
Capture Camera shutter
Upload success Confirmation chime
Upload failure Error tone
OCR complete Processing complete
Achievement Celebration fanfare
Update available Gentle reminder

Replace defaults with your own MP3 files in the sounds folder. See Configuration Files for details.