URL 스키마 | Snapzy Docs

개요

Raycast, Alfred, 단축어(Shortcuts) 앱, 터미널, 브라우저 등 URL을 열 수 있는 모든 앱에서 Snapzy의 주요 동작을 실행할 수 있습니다. snapzy:// 링크를 열기만 하면 됩니다.

요구 사양 — URL 스키마 기능이 동작하려면 Snapzy가 백그라운드에서 작동 중이어야 합니다. 앱이 열려 있지 않은 경우 macOS가 앱을 먼저 실행한 다음 요청한 동작을 실행합니다.

지원되는 액션

전체 화면 캡처

snapzy://capture/fullscreen

영역 캡처

snapzy://capture/area

캡처 마크업

snapzy://capture/area-annotate

개체 컷아웃

snapzy://capture/object-cutout

스크롤 캡처

snapzy://capture/scrolling

텍스트 캡처 (OCR)

snapzy://capture/ocr

애플리케이션 창 캡처

snapzy://capture/application

화면 녹화

snapzy://record/screen

애플리케이션 창 녹화

snapzy://record/application

주석 편집기 열기

snapzy://open/annotate

비디오 편집기 열기

snapzy://open/video-editor

클라우드 업로드 열기

snapzy://open/cloud-uploads

기록 열기

snapzy://open/history

단축키 목록 표시

snapzy://show/shortcuts

설정 열기

snapzy://settings

특정 설정 탭 열기

snapzy://settings?tab=shortcuts

단축어(Shortcuts) 앱 사용 예시

macOS 단축어 앱에서 나만의 자동화 워크플로우를 생성할 수 있습니다:

단축어 앱을 열고 새로운 단축어를 생성합니다.
URL 열기(Open URLs) 동작을 추가합니다.
snapzy://capture/area를 입력합니다.
단축어 상세 설정에서 키보드 단축키를 지정합니다.

이제 생성한 단축어나 모든 자동화 프로세스에서 곧바로 영역 캡처를 실행할 수 있습니다.

터미널 및 스크립트 활용

터미널이나 쉘 스크립트에서는 open 명령어를 이용하세요:

open "snapzy://capture/fullscreen"

이는 시각적 회귀(Visual regression) 캡처가 필요한 테스트 CI 워크플로우나 더 큰 자동화 파이프라인에 Snapzy를 연동할 때 매우 유용합니다.

Raycast 및 Alfred 연동

Raycast와 Alfred 모두 사용자 정의 URL 열기를 완벽히 지원합니다. 임의의 snapzy:// 경로를 가리키는 새로운 스크립트나 URL 실행 액션을 생성하고 단축키(핫키)를 지정하면, 메뉴 막대 아이콘을 일일이 누르지 않고도 즉시 캡처를 실행할 수 있습니다.

개요