Схема URL-адресов

Обзор

Любое приложение, способное открывать URL-адреса (например, Raycast, Alfred, Команды/Shortcuts, Терминал или браузер), может запускать действия Snapzy. Просто откройте ссылку snapzy://.

Требование — Для работы схемы URL-адресов Snapzy должен быть запущен. Если приложение закрыто, macOS сначала запустит его, а затем выполнит действие.

Поддерживаемые схемы и псевдонимы

Каждое действие поддерживает основную схему URL вместе с несколькими альтернативными псевдонимами (алиасами) для удобства.

1. Снимки экрана (Screenshots)

Захват всего экрана

Создает снимок всего экрана.

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

Захват области

Запускает интерактивный инструмент выбора области экрана.

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

Снимок окна приложения

Создает снимок конкретного окна приложения.

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

Захват active-окна

Мгновенно захватывает активное/фокусированное окно.

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

Разметка при захвате

Захватывает выбранную область и сразу открывает её в редакторе разметки/аннотаций.

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

Захват с прокруткой

Запускает захват с прокруткой для длинных веб-страниц или документов.

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

Захват текста (OCR)

Позволяет выбрать область экрана для распознавания и извлечения текста.

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

Захват смарт-элемента

Автоматически обнаруживает элементы пользовательского интерфейса при наведении курсора.

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

Вырезание объекта

Позволяет выделить область для отделения основного объекта и удаления фона.

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

2. Запись экрана (Screen Recordings)

Запись экрана

Запускает запись видео экрана или создание анимации GIF.

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

Запись окна приложения

Начинает запись выбранного окна приложения.

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

3. Открытие панелей (Open Views)

Открыть редактор аннотаций

Открывает чистый редактор разметки и аннотаций.

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

Открыть видеоредактор

Открывает чистый видеоредактор.

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

Открыть облачные загрузки

Открывает вашу историю загрузок в Cloud.

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

Открыть историю

Открывает локальную историю захватов и записей.

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

Показать список горячих клавиш

Выводит окно с горячими клавишами Snapzy.

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

4. Настройки и параметры (Settings & Preferences)

Базовая структура URL

Открыть экран настроек можно с помощью путей:

snapzy://settings
snapzy://preferences

Для открытия конкретной вкладки используйте сегмент пути или параметр запроса:

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

Поддерживаемые вкладки настроек

Раздел настроек	Имя вкладки (`<tab_name>`)	Поддерживаемые псевдонимы
Общие настройки	`general`
Настройки захвата	`capture`	`screenshots`, `screenshot`
Редактор аннотаций	`annotate`	`annotation`, `annotations`
Панель быстрого доступа	`quick-access`	`quickaccess`
История	`history`
Горячие клавиши	`shortcuts`	`keyboard-shortcuts`
Разрешения системы	`permissions`	`privacy`
Облачное хранилище	`cloud`	`uploads`
Дополнительные настройки	`advanced`	`configuration`, `config`, `toml`
О программе Snapzy	`about`

Пример в приложении «Команды» (Shortcuts)

Вы можете создать автоматизацию в стандартном приложении «Команды» (Shortcuts) в macOS:

Откройте «Команды» и создайте новую команду.
Добавьте действие Открыть URL-адреса (Open URLs).
Введите snapzy://capture/area.
Назначьте сочетание клавиш в настройках команды.

Теперь вы можете запускать захват области из любой команды или рабочего процесса автоматизации.

Терминал и скрипты

Из Терминала или скриптов оболочки используйте команду open:

open "snapzy://capture/fullscreen"

Это удобно для интеграции Snapzy в более крупные процессы автоматизации или рабочие процессы CI, которым требуются снимки для визуального регрессионного тестирования.

Raycast и Alfred

И Raycast, и Alfred поддерживают открытие пользовательских URL-адресов. Создайте новый скрипт или действие открытия URL, ведущее на любой путь snapzy://, привяжите горячую клавишу и запускайте захват, не касаясь строки меню.