URL Scheme | Snapzy Docs

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 Schemes & Aliases

Each action supports a primary URL scheme along with several alternative aliases for convenience.

1. Screenshots

Capture Fullscreen

Captures the entire screen.

snapzy://capture/fullscreen
snapzy://capture-screen
snapzy://capture-fullscreen
snapzy://fullscreen
snapzy://screenshot/fullscreen

Capture Area

Kicks off the interactive area selection tool.

snapzy://capture/area
snapzy://capture-area
snapzy://area
snapzy://screenshot/area

Capture Application Window

Captures a specific application window.

snapzy://capture/application
snapzy://capture/window
snapzy://application-capture
snapzy://window-capture
snapzy://screenshot/window

Capture Active Window

Immediately captures the active/focused window.

snapzy://capture/active-window
snapzy://capture/focused-window
snapzy://active-window-capture
snapzy://active-window
snapzy://screenshot/active-window

Capture Area & Annotate

Captures the selected area and opens it directly in the annotation/markup editor.

snapzy://capture/area-annotate
snapzy://capture-area-annotate
snapzy://area-annotate
snapzy://screenshot/area-annotate

Scrolling Capture

Starts a scrolling capture to grab long web pages or documents.

snapzy://capture/scrolling
snapzy://scrolling-capture
snapzy://capture-scrolling
snapzy://scrolling
snapzy://screenshot/scrolling

Capture Text (OCR)

Select an area to extract text using OCR.

snapzy://capture/ocr
snapzy://capture/text
snapzy://capture-text
snapzy://ocr
snapzy://text

Smart Element Capture

Detects UI elements automatically when hover-capturing.

snapzy://capture/smart-element
snapzy://smart-element
snapzy://capture-smart-element
snapzy://smart

Object Cutout

Selects an area to separate and cut out the main object/remove background.

snapzy://capture/object-cutout
snapzy://object-cutout
snapzy://capture-object-cutout
snapzy://cutout

2. Screen Recordings

Record Screen

Starts video/GIF screen recording.

snapzy://record/screen
snapzy://record-screen
snapzy://screen-recording
snapzy://recording
snapzy://record

Record Application Window

Records a selected application window.

snapzy://record/application
snapzy://record/window
snapzy://application-recording
snapzy://window-recording
snapzy://recording/window

3. Open Views

Open Annotation Editor

Opens an empty annotation/markup editor.

snapzy://open/annotate
snapzy://annotate
snapzy://open-annotate

Open Video Editor

Opens an empty video editor.

snapzy://open/video-editor
snapzy://video-editor
snapzy://edit-video
snapzy://open-video-editor

Open Cloud Uploads

Opens your Cloud uploads history.

snapzy://open/cloud-uploads
snapzy://cloud-uploads
snapzy://uploads
snapzy://open-uploads

Open History

Opens local capture and recording history.

snapzy://open/history
snapzy://history
snapzy://capture-history

Show Shortcuts List

Displays keyboard shortcuts list.

snapzy://show/shortcuts
snapzy://shortcuts
snapzy://keyboard-shortcuts
snapzy://show-shortcuts

4. Settings & Preferences

Basic URL Structure

Open Settings using either:

snapzy://settings
snapzy://preferences

To open a specific tab, use paths or query parameters:

snapzy://settings/<tab_name>
snapzy://preferences/<tab_name>
snapzy://settings?tab=<tab_name>
snapzy://preferences?tab=<tab_name>

Supported Settings Tabs

Tab Target	Tab Name (`<tab_name>`)	Supported Aliases
General Settings	`general`
Capture Settings	`capture`	`screenshots`, `screenshot`
Annotation Editor	`annotate`	`annotation`, `annotations`
Quick Access Panel	`quick-access`	`quickaccess`
History	`history`
Keyboard Shortcuts	`shortcuts`	`keyboard-shortcuts`
System Permissions	`permissions`	`privacy`
Cloud Storage	`cloud`	`uploads`
Advanced Config	`advanced`	`configuration`, `config`, `toml`
About Snapzy	`about`

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.