Skip to content GitHub
Guide contents
English View source

Settings

Settings

CyberSnap's Settings window has 12 tabs: General, Capture, Video & GIF, OCR, Notifications, Sounds, Hotkeys, Widget, Editor, Gallery, Uploads, and Backup & Data. There is no Appearance tab (theme/scale/language live under General → Interface) and no Achievements section (celebrations are a toggle in the Notifications tab; achievements themselves open in their own window).

Every title-bar More menu also carries a Help submenu with the contextual wiki page.


General

Interface

Setting Options / Default
Language Auto (system language) + installed translations; default auto
App theme CyberSnap signature dark (default), Dark Grayscale, Light, System (follows Windows)
UI scale 90% (1.0), 100% (1.1, default), 110% (1.2), 120% (1.3), 130% (1.4)
Show instruction banners On by default
Animated effects On by default
Confirm before exit On by default

Saving

Setting Description
Save folder Picker; defaults to %Pictures%\CyberSnap (separate toggles for images, MP4, GIF)
Create monthly subfolders yyyy-MM folders; on by default
File name pattern Presets + Custom with tokens ({year} {month} {day} {hour} {min} {sec} {w} {h} {aspect} {rand}…), live preview, reset ↺
Ask for file name every time Off by default

Standalone Ruler

Setting Default
Capture all screens Off = only occupied screens on multi-monitor
Enable context menu On = right-click shows menu; off = right-click exits

System

Setting Description
Launch on startup On for fresh app defaults; the installer choice is honored on first launch (HKCU ...\Run)
Keep CyberSnap visible in the tray Action button: opens Windows Taskbar settings and auto-opens "Select which icons appear on the taskbar" (search pintrayicon to jump here)
Setup wizard Re-runs the first-launch walkthrough

Hotkeys

Four assignment groups with click-to-assign (Press keys…), per-row clear (×), Reset all, and a PrtSc banner (how to unbind the Snipping Tool, opens ms-settings:easeofaccess-keyboard):

  • Capture & Global — Area Capture, From Center, Fullscreen, Active window, Scrolling Capture, Repeat last area, Screen Recorder MP4, Screen Recorder GIF, plus the four standalone tools (OCR, Color Picker, QR & Barcodes, Ruler)
  • Capture Toolbar — annotation tools used inside the overlay (single-key defaults: F1–F12, 1, 2, Ctrl+Z undo, plus in-capture O/C/Q/R for OCR/color/QR/ruler)
  • Annotations Editor — Pan (Space), Pick, tools, Crop (3), Cut Out (4), and view shortcuts (zoom 7/8/9/0)

Only Area Capture (Alt+Shift+A) is bound on a fresh install; everything else is unbound until you assign it (Reset restores Alt+Shift+A, annotation defaults like Ctrl+Z, and clears the rest). Modifierless keys are blocked except PrintScreen; conflicts show a toast.


Capture

After Capture

Setting Description
When finished Outcome-step editor (+ add / × remove): editor, viewer, copy, save, auto-share
Capture preview auto-close Don't close, 5 / 10 / 20 (default) / 30 s

Independent Auto-Copy

Clipboard delivery is configured separately for screenshots, scrolling captures, OCR, QR/barcodes, MP4, GIF, and colors. Changing one type does not change any other type. Ordinary and scrolling captures also have separate preview preferences; image presets preserve the scrolling preferences.

  • Screenshots: the Clipboard step under When finished, or Auto-copy screenshots under Capture Behavior. Image presets and the setup wizard affect screenshot delivery only.
  • Scrolling captures: their own Auto-copy and Show preview after capture options in the widget's More menu.
  • OCR: Auto-copy OCR text in Settings or Auto-copy in the OCR result window/overlay.
  • QR/barcodes: Auto-copy QR/barcode results in Settings or Auto-copy in the scanner result window.
  • MP4 / GIF: each format has its own Clipboard outcome step.
  • Colors: Auto-copy in the color detail window.

OCR, QR, and color tools also have Show this window. Hiding a result window enables auto-copy for that tool if needed. Turning off auto-copy keeps that tool's result window enabled. Both options can be on together.

Selection

Setting Default
Default capture method Drag-to-select rectangle (alternatives: From Center, Freeform)
Center aspect ratio Free, Square, 16:9, 4:3, 3:2, 9:16 (visible for Center mode)
Show cursor / crosshairs / magnifier / selection size Cursor off, crosshairs off, magnifier on, size on
Overlay across all monitors On
Annotation shadow On

Capture Behavior

Setting Options
Window detection Smart window/element detection
Capture delay None, 3 s, 5 s, 10 s
Toolbar dock Top, Bottom (default), Left, Right
Auto-copy screenshots On by default; controls image captures only
Auto-copy QR/barcode results Off by default; controls decoded content only

Image Output

Setting Options
Default format PNG (default), JPG, BMP
JPG quality 100 / 90 / 85 (default) / 75 / 60 presets
Max image size Original (default), 2160 / 1440 / 1080 / 720 / 480 long edge

Scrolling Capture

Setting Options
Mode Manual / Autoscroll (default)

Video & GIF

Independent MP4 and GIF defaults (also switchable live from the recording bar):

MP4 Setting Default
Quality Max resolution selector
Video FPS 15 / 24 / 30 / 60
Show cursor Toggle
Open trimmer after video Toggle (mirrors the bar's trimmer switch)
Auto-copy video Toggle
Microphone / desktop audio Separate toggles
GIF Setting Default
GIF FPS 15 / 30 only
Show cursor in GIF Toggle
Open trimmer after GIF Toggle
Auto-copy GIF Toggle

OCR

Setting Description
OCR language Auto-detect (default) or manual; type to filter the list
Auto-copy OCR text Copy results automatically (separate from showing the window)
Show the OCR result window Open the result window after recognition, whether or not the text was copied
Pin result window Pin the OCR Result window by default
Translate from / to Default translation languages; type to filter
Translation engine Runtime/model selector with Google API key field and console link

Full workflow lives on the OCR & Translation page.


Notifications (Notifications Tab)

Setting Description
Master toggle Enable/disable all toasts
System notifications Brief text-only status messages (needs master on)
Celebrations Achievement celebration toasts
Position Toast corner/edge (default TopCenter)
Monitor Auto/Follow or a fixed monitor
Capture / system duration How long each toast kind stays visible (2.5 s / 4.0 s)
Fade-out Fade-out animation length (1.0 s)
Preview click action Left-click on toast preview body (editor, viewer, copy, save, Gallery, close)
Quiet hours Mute non-error toasts on a schedule (22:00–07:00 default)

Details: Notifications. (The old toast button-layout designer was removed; presets/positions are no longer configurable.)


Sounds (Sounds Tab)

Setting Description
Master switch All-sounds-on toggle (flips off automatically when every event is muted)
Per-event cards Mute toggle, play preview, browse for a custom MP3/WAV, reset to Built-in
Reset all Clear every custom file and unmute everything

Events: Startup, Capture, Color picker, OCR Text, QR / Barcode scan, Recording start, Recording stop, Upload / Share, Achievement, System notification, Capture preview, Error.


Widget

Single Floating Widget card:

Setting Default
Show edge capture widget On (hover/click peeking widget; toggling rebuilds it)
Always on top On
Capture cursor Mirrors Capture → Show cursor
Widget edge Top (Top / Bottom / Left / Right)
Edge hover delay 0 / 100 / 250 / 500 / 1000 ms
Widget monitor Automatic follows the active monitor; a fixed monitor can also be selected
Reset position Button; centered default (rows dim while the widget is hidden)

Widget menus and Settings synchronize always-on-top, edge, monitor, hover delay, and placement. The widget's More menu groups delivery preferences by mode, including separate MP4 and GIF Trimmer switches; open result windows synchronize their delivery toggles as well.


Editor

Appearance (canvas only)

Auto-fit on open (off), canvas outline (on), instruction banners (on), welcome banner (on), status-bar hints (on), coordinates (on), tooltips (on), rulers (on), auto-crop controls (on), resize handles (on), handles-scale-content (off = extend/trim), Pan-mode object lock (on).

Performance

Setting Options
Undo history limit 1 / 10 / 25 / 50 / 100 / 150 / 200

Export

Setting Options
Preferred export format PNG (default) / JPEG / PDF

Dialogs

Setting Description
Reset suppressed dialogs Button; restores resize/paste/transform-flatten confirmations, third-party upload, preview close-all, and recording-settings-exit prompts

Gallery (History Tab)

The tab itself is labeled Gallery in the UI.

Storage & Retention

Setting Default
Save captures to Gallery On
Save standalone tools to Gallery On (Color Picker, OCR, QR/Barcode results)
Auto-delete old captures Never (1 day / 7 days / 30 days / 3 months)
Limit captures No limit (or keep only the newest 50 / 100 / 250 / 500 / 1000)
Delete original files Off (pruned items only hide from the Gallery; on = files are deleted from disk too)

Interaction

Setting Options
Thumbnail click action Open in editor (default) / Copy to clipboard / Open in default viewer (videos open the trimmer)

Search

Setting Description
Show image search bar On
Auto-index images Off
Image search index Reset index button (confirm → background OCR-text rebuild + Gallery refresh)

Uploads

Five sub-tabs: General (default provider, PNG/JPEG format, open-URL-after-upload), CyberSnap Share (server URL, optional personal API key), ImgBB (optional key), Imgur (Client-ID-gated), Custom destination (FTP/SFTP/S3/Webhook: protocol, host, port, username, password, remote directory, public URL base, webhook URL).

Each provider card has a Test upload button. Details: Upload & Share.


Backup & Data

Single Data & Storage card:

Action Behavior
Open Folder Opens the data dir in Explorer (settings, achievements, cache)
Export Saves CyberSnap-settings.json with API keys redacted (settings + achievements)
Import Loads a *.json export, replaces settings, rolls back on failure
Reset (red) Triple confirmation, then restores factory defaults (hotkeys, uploads, preferences all lost)

Scoped resets live where they belong: Editor → Dialogs, Gallery → Search index, Hotkeys → Reset all, Sounds → Reset all, General → file-name ↺.

← All documentation