Documentation

Documentation

Cài đặt

Các cách cài đặt Snapzy trên máy Mac của bạn. Chọn phương thức phù hợp nhất với nhu cầu của bạn.

Yêu cầu hệ thống

  • macOS 13 Ventura trở lên
  • Mac sử dụng Apple Silicon hoặc vi xử lý Intel
  • Khoảng 120 MB dung lượng ổ cứng trống
  • Chỉ cần kết nối Internet khi tải ảnh/video lên dịch vụ lưu trữ đám mây (tùy chọn)

Tải file DMG

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

Cài đặt qua Homebrew

Nếu sử dụng Homebrew, bạn có thể cài đặt Snapzy trực tiếp bằng lệnh:

brew install --cask snapzy

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

Shell script

Cài đặt phiên bản mới nhất qua curl (tự động nhận diện bản phát hành mới nhất):

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

Để cài đặt một phiên bản cụ thể, sử dụng tham số VERSION:

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/install.sh | VERSION=<version> bash

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

Snapzy là phần mềm mã nguồn mở. Bạn hoàn toàn có thể tự build ứng dụng trên máy của mình bằng Xcode:

  1. Clone repository: git clone https://github.com/duongductrong/Snapzy.git
  2. Mở file Snapzy.xcodeproj bằng Xcode 15 trở lên.
  3. Chọn target Snapzy và chọn thiết bị đích là Mac của bạn.
  4. Nhấn tổ hợp phím ⌘R để tiến hành build và chạy.

Cấp quyền trong lần chạy đầu tiên

Trong lần khởi chạy đầu tiên, Snapzy sẽ yêu cầu các quyền hệ thống macOS sau:

  • Ghi màn hình (Screen Recording) — Bắt buộc phải có để chụp ảnh và quay video màn hình.
  • Microphone — Tùy chọn, chỉ cần thiết nếu bạn muốn thu âm giọng nói khi quay màn hình.
  • Trợ năng (Accessibility) — Tùy chọn, dùng cho các tính năng phím tắt toàn hệ thống và tự động nhận diệ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 quản lý và thu hồi các quyền này.

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ộ file cấu hình và bộ nhớ đệm (cache), đồng thời reset các quyền TCC (Screen Recording, Microphone, Accessibility). 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.