URL Scheme

Tổng quan

Bất kỳ ứng dụng nào có khả năng mở URL — ví dụ như Raycast, Alfred, ứng dụng Phím tắt (Shortcuts), Terminal hoặc trình duyệt — đều có thể kích hoạt các hành động của Snapzy. Chỉ cần mở một liên kết snapzy://.

Các hành động & Bí danh được hỗ trợ

Mỗi hành động đều hỗ trợ một URL scheme chính cùng với nhiều bí danh (aliases) thay thế tiện lợi khác.

1. Chụp ảnh màn hình (Screenshots)

Chụp toàn màn hình

Chụp toàn bộ màn hình hiển thị.

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

Chụp vùng màn hình

Kích hoạt công cụ chọn vùng chụp tương tác.

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

Chụp cửa sổ ứng dụng

Chụp ảnh màn hình của một cửa sổ ứng dụng cụ thể.

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

Chụp cửa sổ đang hoạt động

Chụp ngay lập tức cửa sổ đang được chọn/hoạt động (active).

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

Chụp & Chú thích tại chỗ

Chụp vùng được chọn và mở trực tiếp trong trình biên tập chú thích/đánh dấu.

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

Chụp cuộn trang

Bắt đầu chế độ chụp cuộn để chụp các trang web hoặc tài liệu dài.

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

Chụp trích xuất văn bản (OCR)

Chọn một vùng màn hình để nhận diện và trích xuất chữ viết bằng OCR.

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

Chụp thành phần thông minh

Tự động phát hiện các thành phần giao diện (UI elements) khi di chuột qua.

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

Chụp tách chủ thể

Chọn vùng để tách đối tượng chính hoặc loại bỏ nền.

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

2. Ghi video màn hình (Screen Recordings)

Ghi video màn hình

Bắt đầu ghi video hoặc ảnh động GIF màn hình.

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

Ghi video cửa sổ ứng dụng

Ghi video cửa sổ ứng dụng được chọn.

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

3. Mở giao diện phụ (Open Views)

Mở trình biên tập chú thích

Mở một trình chỉnh sửa chú thích/đánh dấu trống.

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

Mở trình biên tập video

Mở trình chỉnh sửa video trống.

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

Mở lịch sử tải lên đám mây

Mở danh sách các tệp đã tải lên Cloud.

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

Mở lịch sử

Mở lịch sử chụp ảnh và ghi video cục bộ.

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

Hiển thị danh sách phím tắt

Hiển thị danh sách các phím tắt bàn phím.

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

4. Cài đặt & Tùy chọn (Settings & Preferences)

Cấu trúc URL cơ bản

Mở cửa sổ Cài đặt bằng một trong hai đường dẫn:

snapzy://settings
snapzy://preferences

Để mở trực tiếp một tab cài đặt cụ thể, sử dụng cấu trúc đường dẫn hoặc tham số truy vấn:

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

Danh sách tab cài đặt được hỗ trợ

Cài đặt	Mã tab (<tab_name>)	Bí danh hỗ trợ
Cài đặt chung	general
Chụp màn hình	capture	screenshots, screenshot
Trình chú thích	annotate	annotation, annotations
Bảng truy cập nhanh	quick-access	quickaccess
Lịch sử	history
Phím tắt	shortcuts	keyboard-shortcuts
Quyền hệ thống	permissions	privacy
Lưu trữ đám mây	cloud	uploads
Cấu hình nâng cao	advanced	configuration, config, toml
Thông tin ứng dụng	about

---

Ví dụ sử dụng ứng dụng Phím tắt (Shortcuts)

Bạn có thể tạo một tự động hóa cá nhân trong ứng dụng Phím tắt (Shortcuts) trên macOS:

1. Mở ứng dụng Phím tắt và tạo một phím tắt mới.
2. Thêm hành động Mở URL (Open URLs).
3. Nhập snapzy://capture/area.
4. Gán một phím tắt bàn phím trong phần cài đặt của phím tắt đó.

Bây giờ bạn có thể kích hoạt chế độ chụp vùng màn hình từ bất kỳ Phím tắt hoặc quy trình tự động hóa nào.

Terminal & Script

Từ Terminal hoặc các shell script, hãy sử dụng lệnh open:

open "snapzy://capture/fullscreen"

Điều này rất hữu ích để tích hợp Snapzy vào các quy trình tự động hóa lớn hơn hoặc quy trình CI cần chụp màn hình để kiểm tra sai lệch giao diện.

Raycast & Alfred

Cả Raycast và Alfred đều hỗ trợ mở các URL tùy chỉnh. Hãy tạo một script mới hoặc hành động mở URL trỏ đến bất kỳ đường dẫn snapzy:// nào, gán phím nóng và kích hoạt việc chụp màn hình mà không cần chạm vào thanh menu.