URL Scheme
Snapzy registers the snapzy:// URL scheme so launchers and automation tools can trigger capture actions directly.
Overview
Any app that can open URLs — Raycast, Alfred, Shortcuts, Terminal, or a browser — can trigger Snapzy actions. Just open a snapzy:// link.
Requirement — Snapzy must be running for URL scheme actions to work. If it is not open, macOS will launch it first, then execute the action.
Supported Actions
Capture Fullscreen
snapzy://capture/fullscreen
Capture Area
snapzy://capture/area
Object Cutout
snapzy://capture/object-cutout
Scrolling Capture
snapzy://capture/scrolling
Capture Text (OCR)
snapzy://capture/ocr
Record Screen
snapzy://record/screen
Open Annotation Editor
snapzy://open/annotate
Open Video Editor
snapzy://open/video-editor
Open Cloud Uploads
snapzy://open/cloud-uploads
Open History
snapzy://open/history
Show Shortcuts List
snapzy://show/shortcuts
Open Settings
snapzy://settings
Open Settings Tab
snapzy://settings?tab=shortcuts
Shortcuts App Example
You can create a personal automation in the macOS Shortcuts app:
- Open Shortcuts and create a new shortcut.
- Add the Open URLs action.
- Enter
snapzy://capture/area. - Assign a keyboard shortcut in Shortcuts settings.
Now you can trigger an area capture from any Shortcut or automation workflow.
Terminal & Scripts
From Terminal or shell scripts, use the open command:
open "snapzy://capture/fullscreen"
This is useful for integrating Snapzy into larger automation pipelines or CI workflows that need visual regression captures.
Raycast & Alfred
Both Raycast and Alfred support opening custom URLs. Create a new script or open-URL action pointing to any snapzy:// path, bind a hotkey, and trigger captures without touching the menu bar.