URL 스키마

개요

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

지원되는 스키마 및 에일리어스

각 작업은 편의를 위해 기본 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

활성 창 캡처

현재 활성화되어 있거나 포커스된 창을 즉시 캡처합니다.

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)

영역을 선택하여 OCR로 텍스트를 추출합니다.

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

스마트 엘리먼트 캡처

마우스를 올렸을 때 UI 요소를 자동으로 감지하여 캡처합니다.

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

클라우드 업로드 열기

클라우드 업로드 기록을 엽니다.

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

기록 열기

로컬 캡처 및 녹화 기록을 엽니다.

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

단축키 목록 표시

키보드 단축키 목록을 표시합니다.

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) 앱 사용 예시

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

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

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

터미널 및 스크립트 활용

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

open "snapzy://capture/fullscreen"

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

Raycast 및 Alfred 연동

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