Cài đặt | Snapzy Docs

Yêu cầu hệ thống

macOS 13 Ventura trở lên
Thiết bị Mac chip Apple Silicon hoặc Intel
Bộ nhớ trống ~120 MB
Chỉ cần kết nối Internet khi tải ảnh/video lên đám mây (không bắt buộc)

Tải xuống tệp DMG

Tải bản .dmg mới nhất từ trang tải xuống.
Mở tệp DMG và kéo Snapzy vào thư mục Applications (Ứng dụng).
Khởi chạy Snapzy từ Applications hoặc Spotlight.

Lần đầu khởi chạy — Snapzy v1.25.0 trở đi đã được Apple chứng nhận (notarized), nên macOS Gatekeeper cho phép ứng dụng mở bình thường. Nếu bạn thấy cảnh báo bảo mật, hãy vào Cài đặt hệ thống → Quyền riêng tư & Bảo mật và nhấp Vẫn mở. Người dùng cập nhật từ các bản ad-hoc cũ có thể cần cấp lại quyền vì macOS gắn quyền với danh tính ký ứng dụng; xem Quyền hạn & Quyền riêng tư.

Cài đặt qua Homebrew

Nếu sử dụng Homebrew, bạn có thể thêm tap của Snapzy và cài đặt bằng lệnh:

brew tap duongductrong/snapzy https://github.com/duongductrong/Snapzy
brew install --cask snapzy

Ứng dụng sẽ tự động cập nhật khi bạn chạy lệnh brew upgrade.

Sử dụng Shell Script

Cài đặt một phiên bản cụ thể qua curl:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.12.5/install.sh | bash

Biên dịch từ mã nguồn

Snapzy is open source. Bạn có thể tự build ứng dụng trên máy của mình bằng Xcode:

Clone kho lưu trữ: git clone https://github.com/duongductrong/Snapzy.git
Mở dự án Snapzy.xcodeproj bằng Xcode 15 hoặc mới hơn.
Chọn target Snapzy và chọn thiết bị Mac của bạn làm đích đến (destination).
Nhấn phím ⌘R để biên dịch và chạy ứng dụng.

Mẹo — Tự build từ mã nguồn là cách tuyệt vời nếu bạn muốn tùy chỉnh các phím tắt hoặc đóng góp code cho dự án. Bạn không cần tài khoản Apple Developer để chạy ứng dụng local.

Cấp quyền khi khởi chạy lần đầu

Trong lần khởi chạy đầu tiên, Snapzy sẽ yêu cầu cấp các quyền macOS sau:

Ghi màn hình (Screen Recording) — bắt buộc để chụp màn hình và quay video.
Thư mục lưu (Save Folder) — bắt buộc để Snapzy có thể ghi ảnh chụp và video vào thư mục bạn chọn.
Microphone — không bắt buộc, chỉ cần thiết nếu bạn muốn ghi kèm giọng nói của mình khi quay video màn hình.
Trợ năng (Accessibility) — không bắt buộc, được sử dụng cho các phím tắt toàn hệ thống và tự động phát hiện cửa sổ ứng dụng.

Xem phần Quyền & Quyền riêng tư để biết thêm chi tiết về cách cấp quyền hoặc thu hồi quyền.

Gỡ cài đặt

Để gỡ cài đặt hoàn toàn Snapzy, thu hồi các quyền hệ thống và dọn dẹp dữ liệu ứng dụng:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

Lệnh này sẽ xóa ứng dụng khỏi /Applications, xóa toàn bộ tệp cấu hình và cache, đồng thời đặt lại các quyền TCC (Ghi màn hình, Micro, Trợ năng). Bạn có thể cần đăng xuất hoặc khởi động lại máy để các thay đổi về quyền có hiệu lực hoàn toàn.