Documentation

URL Scheme

Snapzy đăng ký URL scheme snapzy:// để các trình khởi chạy và công cụ tự động hóa có thể kích hoạt trực tiếp các thao tác chụp màn hình.

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://.

Yêu cầu — Snapzy phải đang chạy để các hành động của URL scheme hoạt động. Nếu ứng dụng chưa mở, macOS sẽ khởi chạy ứng dụng trước, sau đó mới thực hiện hành động.

Các hành động được hỗ trợ

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

snapzy://capture/fullscreen

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

snapzy://capture/area

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

snapzy://capture/area-annotate

Chụp tách chủ thể

snapzy://capture/object-cutout

Chụp cuộn trang

snapzy://capture/scrolling

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

snapzy://capture/ocr

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

snapzy://capture/application

Ghi video màn hình

snapzy://record/screen

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

snapzy://record/application

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

snapzy://open/annotate

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

snapzy://open/video-editor

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

snapzy://open/cloud-uploads

Mở lịch sử

snapzy://open/history

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

snapzy://show/shortcuts

Mở cài đặt

snapzy://settings

Mở tab cài đặt cụ thể

snapzy://settings?tab=shortcuts

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.

Sẵn sàng chụp
tác phẩm tốt nhất của bạn?

Tham gia cộng đồng mã nguồn mở xây dựng công cụ chụp màn hình tốt nhất cho macOS.

macOS 13+ · Intel & Apple Silicon