Skip to content

Latest commit

 

History

History
266 lines (198 loc) · 16.6 KB

File metadata and controls

266 lines (198 loc) · 16.6 KB
Banner Snapzy

Snapzy

Chụp màn hình, quay màn hình, chú thích và chỉnh sửa macOS thuần native ngay từ thanh menu.

duongductrong%2FSnapzy | Trendshift

Built with SwiftUI, AppKit, ScreenCaptureKit, Vision, and Sparkle.

🇺🇸 English🇻🇳 Tiếng Việt🇨🇳 简体中文

Tính năngCài đặtPhím tắtTự động hóaDevelopmentTài liệuCộng đồngBảo mậtĐóng gópCộng tác viênLời cảm ơn

GitHub Stars GitHub Forks GitHub Downloads

Hỏi DeepWiki Tham gia cộng đồng Discord Được giới thiệu trên

GitHub Sponsors Ko-fi Donate

Tính năng

  • Chụp màn hình: chụp toàn màn hình hoặc vùng chọn với chuyển đổi giữa chế độ chọn tay/chế độ cửa sổ ứng dụng (Application Capture, mặc định A), chụp vùng kèm chú thích nhanh (annotate trước khi lưu), chụp cuộn với xem trước ghép ảnh trực tiếp, trích xuất văn bản OCR, chụp cắt đối tượng nền trong suốt với tự động crop an toàn tùy chọn, giữ bóng cửa sổ (macOS 14+), xuất nhiều định dạng (PNG/JPG/WebP), ẩn icon/widget desktop, chụp nhanh khi đang quay
  • Quay màn hình: xuất video hoặc GIF, thu âm thanh hệ thống + microphone, làm nổi bật cú nhấp chuột, overlay phím bấm, chú thích trực tiếp trên màn hình, nhớ vùng quay gần nhất, resize GIF, metadata Smart Camera cho chỉnh sửa Follow Mouse
  • Trình chỉnh sửa chú thích: shape, mũi tên, văn bản, watermark, hình chữ nhật tô màu, blur/pixelate, counter, crop, xóa nền với auto-crop nhận biết vùng cắt, nền mockup với 3D renderer, zoom/pan (pinch + bàn phím), kéo thả sang app khác, shortcut công cụ có thể cấu hình
  • Thiết lập sau khi chụp: ma trận hành động theo từng chế độ cho lưu, Quick Access, copy clipboard và annotate, cùng một tùy chọn auto-crop toàn cục riêng cho remove background (bật mặc định)
  • Trình chỉnh sửa video: cắt với timeline trực quan + dải frame, zoom segment với auto-focus (Follow Mouse), nền wallpaper + padding, kích thước export tùy chỉnh, trình xem GIF động, undo/redo
  • Quick Access: bảng nổi sau mỗi lần chụp với các thao tác copy, edit, drag-to-app, open và delete
  • Lịch sử capture: panel history nổi + cửa sổ duyệt đầy đủ cho screenshot, video và GIF gần đây, có lọc theo loại/thời gian, tìm theo tên file, thao tác copy/open/delete nhanh, mở lại bằng Annotate hoặc Video Editor chỉ với một lần nhấn, restore annotation đã commit để tiếp tục chỉnh sửa, tùy chỉnh layout panel, và retention policy
  • Shortcut: shortcut toàn cục cấu hình đầy đủ cho chụp, quay và công cụ annotate, có bật/tắt cho từng shortcut và phát hiện xung đột hệ thống
  • Onboarding: màn hình chào, chọn ngôn ngữ lần đầu, hướng dẫn cấp quyền, và cấu hình shortcut cho người dùng lần đầu
  • Bản địa hóa: bản địa hóa ứng dụng cho 🇺🇸 English, 🇻🇳 Vietnamese, 🇨🇳 Simplified Chinese, 🇹🇼 Traditional Chinese, 🇪🇸 Spanish, 🇯🇵 Japanese, 🇰🇷 Korean, 🇷🇺 Russian, 🇫🇷 French và 🇩🇪 German, hỗ trợ chọn ngôn ngữ riêng cho từng app theo macOS
  • Cloud Upload: quyền riêng tư trước hết với mô hình tự mang storage bằng AWS S3 hoặc Cloudflare R2, không dùng server bên thứ ba, upload thủ công từ Quick Access cho screenshot, video và GIF, hoặc từ Annotate cho screenshot, credential lưu trong macOS Keychain với bảo vệ mật khẩu tùy chọn, import/export credential mã hóa thủ công để thiết lập nhanh trên Mac khác, lịch sử upload, auto-expiration cấu hình được (1–90 ngày hoặc vĩnh viễn), lifecycle rules, hỗ trợ custom domain
  • Cập nhật & chẩn đoán: cập nhật trong app qua Sparkle, báo vấn đề kèm gói log chẩn đoán, quản lý cache
  • Nền tảng: app thanh menu, giao diện light/dark/system, App Sandbox với bookmark truy cập file an toàn

Cài đặt

Yêu cầu macOS 13.0 trở lên.

Homebrew

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

Script shell

# Cài một phiên bản cụ thể
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.9.8/install.sh | bash

Tải bản phát hành

  1. Mở Releases
  2. Tải asset ứng dụng đã đóng gói mới nhất, thường là Snapzy-v<version>.dmg
  3. Di chuyển Snapzy.app vào /Applications
  4. Mở Snapzy
  5. Cấp quyền Screen Recording khi macOS nhắc trong System Settings
  6. Mở lại Snapzy sau khi cấp quyền Screen Recording nếu macOS yêu cầu
  7. Cấp thêm quyền Microphone nếu bạn muốn ghi giọng nói trong video

Lưu ý: Snapzy hiện chưa được Apple notarize, nên macOS có thể chặn app trong lần mở đầu tiên. Sau khi cài Snapzy vào /Applications, hãy chạy:

sudo xattr -rd com.apple.quarantine /Applications/Snapzy.app

Tìm hiểu thêm tại Apple Support: Open a Mac app from an unidentified developer.

Gỡ cài đặt

Để xóa hoàn toàn Snapzy, reset mọi quyền và dọn dữ liệu ứng dụng:

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

Hoặc nếu bạn đã clone repo:

./uninstall.sh

Lệnh này sẽ xóa ứng dụng khỏi /Applications, xóa preferences và cache, đồng thời reset quyền TCC (Screen Recording, Microphone, Accessibility). Bạn có thể cần đăng xuất hoặc khởi động lại để thay đổi quyền có hiệu lực hoàn toàn.

Phím tắt

Tác vụ Phím tắt
Chụp toàn màn hình ⇧⌘3
Chụp vùng ⇧⌘4
↳ Chuyển chế độ chọn vùng/cửa sổ ứng dụng (Application Capture) A
Chụp vùng + chú thích nhanh ⇧⌘7
Chụp cuộn ⇧⌘6
Quay màn hình (bật/tắt) ⇧⌘5
Tạm dừng/Tiếp tục quay (tùy chọn, gợi ý ⌘⇧Space) chưa đặt
OCR văn bản ⇧⌘2
Chụp tách nền đối tượng ⇧⌘1
Mở Annotate ⇧⌘A
Mở Video Editor ⇧⌘E
Mở Cloud Uploads ⇧⌘L
Hiện danh sách shortcut ⇧⌘K

Tự động hóa

Snapzy đăng ký URL scheme snapzy:// để launcher và công cụ tự động hóa có thể kích hoạt các thao tác capture.

Tác vụ URL
Chụp toàn màn hình snapzy://capture/fullscreen
Chụp vùng snapzy://capture/area
Chụp cửa sổ ứng dụng snapzy://capture/application
Chụp vùng + chú thích snapzy://capture/area-annotate
Chụp cuộn snapzy://capture/scrolling
OCR văn bản snapzy://capture/ocr
Chụp tách nền đối tượng snapzy://capture/object-cutout
Quay màn hình snapzy://record/screen
Quay cửa sổ ứng dụng snapzy://record/application
Mở Annotate snapzy://open/annotate
Mở Video Editor snapzy://open/video-editor
Mở Cloud Uploads snapzy://open/cloud-uploads
Mở Lịch sử capture snapzy://open/history
Hiện danh sách shortcut snapzy://show/shortcuts
Mở Cài đặt snapzy://settings
Mở tab Cài đặt snapzy://settings?tab=annotate

Development

Để setup local, build từ source, và bắt đầu workflow phát triển, hãy đọc docs/DEVELOPMENT.md.

Nếu bạn cần lệnh archive, export, hoặc đóng gói DMG, xem docs/BUILD.md. Nếu bạn muốn workflow đóng góp, xem CONTRIBUTING.md.

Tài liệu

Cộng đồng

Được giới thiệu trên

Snapzy - Hãy nghĩ tới CleanShot X nhưng mã nguồn mở và thân thiện với developer | Product Hunt Snapzy trên Unikorn.vn

Benchmark

OCR

Ngày benchmark: 19 tháng 4, 2026. Các con số OCR trong README được lấy từ runner có thể tái lập scripts/run-ocr-readme-benchmark.sh, chạy trên corpus sạch dạng UI/article text có xuống dòng với 12 mẫu / ngôn ngữ trên 10 ngôn ngữ được hỗ trợ. Character accuracy là chỉ số chính, exact match được tính rất chặt, và tỷ lệ no-output trên corpus này là 0% cho toàn bộ bảng bên dưới.

Ngôn ngữ Character Accuracy Exact Match
English 100.0% 100.0%
Vietnamese 100.0% 100.0%
Simplified Chinese 99.3% 75.0%
Traditional Chinese 99.0% 66.7%
Spanish 99.9% 91.7%
Japanese 99.4% 66.7%
Korean 99.7% 83.3%
Russian 100.0% 100.0%
French 99.3% 33.3%
German 99.8% 75.0%

Screenshot thực tế có thể thấp hơn corpus này, nhất là khi có emoji, footer tương phản thấp, dấu câu lạ, nền gradient, blur, hoặc font trang trí mạnh.

Bảo mật

Snapzy chạy trong macOS App Sandbox với tập entitlement tối thiểu. Mọi request mạng chỉ phục vụ kiểm tra cập nhật Sparkle và các lần cloud upload do chính người dùng chủ động tới bucket S3/R2 của riêng mình, không có dữ liệu nào được gửi tới server bên thứ ba. Credential cloud được lưu độc quyền trong macOS Keychain, có thể được bảo vệ thêm bằng mật khẩu tùy chọn (băm SHA-256, không bao giờ lưu plaintext), và chỉ có thể chuyển qua luồng export/import mã hóa thủ công được bảo vệ bằng passphrase do người dùng cung cấp. Snapzy không thu thập telemetry.

Để báo cáo lỗ hổng bảo mật, hãy dùng GitHub Security Advisory hoặc liên hệ riêng với maintainer. Xem SECURITY.md để biết đầy đủ chi tiết.

Đóng góp

Mọi đóng góp đều được chào đón. Hãy đọc CONTRIBUTING.md trước khi mở pull request.

Cộng tác viên

Cảm ơn tất cả mọi người đã đóng góp cho Snapzy!

Lịch sử sao

Biểu đồ lịch sử sao

Lời cảm ơn

Snapzy lấy cảm hứng từ CleanShot X, một ứng dụng chụp màn hình và quay màn hình tiên tiến dành cho macOS.

Giấy phép

BSD 3-Clause License. Xem LICENSE.