DeanOpen/MacViewer

MacViewer

Dùng UltraViewer ngay trên máy Mac: điều khiển máy khác hoặc cho người khác truy cập máy Mac của bạn.

Tiếng Việt · English

Tải về MacViewer cho macOS

Bản mới nhất, macOS 14 trở lên

UltraViewer chỉ có bản cho Windows. MacViewer là ứng dụng macOS thuần, giúp bạn kết nối tới máy đang chạy UltraViewer (hoặc MacViewer), và cho phép người khác điều khiển máy Mac của bạn khi bạn đồng ý. Ứng dụng viết bằng SwiftUI/AppKit, không cần Wine và không chạy bất kỳ file .exe nào của Windows.

• Nhập ID và mật khẩu hiện trên UltraViewer của máy kia là kết nối được
• Kết nối được mã hóa, đi qua máy chủ trung gian có TLS; nếu hai máy cùng mạng LAN thì tự kết nối trực tiếp cho nhanh
• Hiển thị màn hình mượt, hỗ trợ cả màn hình 4K
• Điều khiển chuột, bàn phím (chỉ khi bạn bật Điều khiển). Phím được chuyển đổi sẵn: ⌘ → Win, ⌥ → Alt, ⌃ → Ctrl. Cuộn bằng trackpad hay chuột đều được
• Gõ tiếng Việt, tiếng Trung khi điều khiển: dùng bộ gõ của macOS (Telex/VNI, EVKey, Pinyin…). Với tiếng Việt cũng có thể tắt bộ gõ trên Mac và dùng Unikey ở máy kia
• Thanh công cụ: chọn màn hình, thu phóng, chất lượng hình, ẩn/hiện hình nền, con trỏ chuột và nghe âm thanh từ máy kia
• Chụp màn hình (chọn vùng, ghi chú lên ảnh) và quay video
• Chat với người bên kia và đồng bộ clipboard hai chiều (tùy chọn)
• Gửi và nhận file ngay trong chat: bấm 📎 hoặc kéo thả file vào khung chat, bấm Lưu khi có file đến. Thư mục lưu được chọn một lần và đổi trong Cài đặt
• Có thể lưu mật khẩu vào Keychain của macOS cho lần sau
• Đặt tên cho các máy trong danh sách gần đây (chỉ lưu trên máy Mac)

• Người khác chỉ xem hoặc điều khiển được sau khi bạn bấm đồng ý trên máy Mac
• Có hướng dẫn từng bước để bật quyền Ghi màn hình và Trợ năng
• Quyền xem và quyền điều khiển được duyệt riêng. Bạn có thể ngắt kết nối hoặc tạm khóa truy cập bất cứ lúc nào
• Sao chép hoặc tạo mật khẩu mới cho máy Mac; ID giữ nguyên
• Đặt tên hiển thị cho máy Mac trong Cài đặt (chữ không dấu, tối đa 20 ký tự)

• Giao diện tiếng Việt và tiếng Anh, hoặc tự theo ngôn ngữ của máy
• Chạy trên cả chip Apple (M1, M2…) và Intel, yêu cầu macOS 14 Sonoma trở lên

Gửi file khi máy Windows điều khiển máy Mac, nói chuyện qua micro, phát âm thanh khi chia sẻ máy Mac, chia sẻ nhiều màn hình Mac cùng lúc và truy cập không cần người ngồi máy. Chưa thử nghiệm với các bản UltraViewer cũ, bàn phím không phải kiểu US, bộ gõ ngoài tiếng Việt và tiếng Trung, và chế độ màu 8-bit.

Cài bằng Homebrew:

brew install --cask deanopen/tap/macviewer

Hoặc cài thủ công:

1. Vào trang Tải về và tải file MacViewer-<phiên bản>.dmg.
2. Mở file DMG, kéo MacViewer thả vào thư mục Applications.
3. Mở MacViewer từ Launchpad hoặc thư mục Applications.

Khi có bản mới, MacViewer hiện nút Cập nhật lên … trên thanh tiêu đề. Bấm vào, xem có gì mới, rồi bấm Cập nhật và khởi động lại: ứng dụng tự tải về, kiểm tra chữ ký, cài đặt và mở lại. Bạn cũng có thể chọn MacViewer → Kiểm tra bản cập nhật… trên thanh menu.

Nếu macOS báo không mở được ứng dụng, hãy nhấp chuột phải vào MacViewer, chọn Open rồi bấm Open lần nữa. Hoặc chạy lệnh:

xattr -dr com.apple.quarantine /Applications/MacViewer.app

Điều khiển máy khác: Nhập ID và mật khẩu đang hiện trên UltraViewer của máy kia, rồi bấm Kết nối đến máy khác. Muốn dùng chuột và bàn phím thì bật Điều khiển trên thanh công cụ.

Cho người khác vào máy Mac: Bấm Bắt đầu chia sẻ máy Mac và làm theo hướng dẫn để bật quyền:

Gửi ID và mật khẩu của máy Mac cho người kia, rồi bấm đồng ý khi có yêu cầu kết nối. Nếu macOS yêu cầu, hãy tắt và mở lại MacViewer sau khi bật quyền Ghi màn hình.

MacViewer có sẵn MCP server. Nhờ đó các ứng dụng AI và trợ lý lập trình có thể xem màn hình máy kia và dùng chuột, bàn phím trong phiên kết nối bạn đã mở.

1. Mở MacViewer › Cài đặt › Trợ lý AI, bật Cho phép trợ lý AI dùng MacViewer.
2. Trong mục Ứng dụng AI và trợ lý lập trình, bấm Thêm cạnh ứng dụng của bạn, hoặc Thêm vào mọi ứng dụng tìm thấy. Sau đó khởi động lại ứng dụng đó.
3. Kết nối tới máy khác và bật Điều khiển. Rồi nhờ trợ lý, ví dụ: "Chụp màn hình máy kia và mở Notepad."

Hỗ trợ thêm bằng một cú bấm cho Claude Code, Claude Desktop, Cursor, VS Code (GitHub Copilot), VS Code Insiders, Windsurf, Codex, Gemini CLI, Zed, Cline, Roo Code, Kiro, Amazon Q Developer, opencode, LM Studio và Continue. Với Goose, JetBrains AI Assistant và Warp, MacViewer sao chép sẵn cấu hình để bạn dán vào cài đặt của ứng dụng. Ứng dụng khác thì dùng Sao chép cấu hình. Server chạy MacViewer.app/Contents/MacOS/macviewer-mcp (stdio), ví dụ:

claude mcp add --scope user macviewer -- /Applications/MacViewer.app/Contents/MacOS/macviewer-mcp

• Mặc định tính năng này tắt. Mọi thứ chỉ diễn ra trên máy Mac: công cụ trao đổi với ứng dụng qua socket cục bộ mà chỉ tài khoản của bạn mở được.
• Trợ lý chỉ dùng được chuột, bàn phím khi bạn bật Điều khiển. Muốn trợ lý tự kết nối hoặc ngắt kết nối thì phải bật quyền riêng cho việc đó.
• MacViewer hỏi bạn trước khi một trợ lý mới thao tác. Khi trợ lý đang điều khiển, cửa sổ phiên hiện AI đang điều khiển · Dừng.
• Trước khi sửa tệp cấu hình của ứng dụng, MacViewer lưu một bản .macviewer-backup. Tệp nào có chú thích thì MacViewer không ghi đè.

Cần macOS 14 trở lên và Xcode 16 / Swift 6 trở lên.

git clone https://github.com/DeanOpen/MacViewer.git
cd MacViewer

swift test                       # chạy test
scripts/package_app.sh release   # build ra dist/MacViewer.app
open dist/MacViewer.app

Sources/
  MacViewer/              Ứng dụng (giao diện, chụp màn hình, điều khiển, chia sẻ)
  UltraViewerProtocol/    Phần giao thức: mã hóa, kết nối, giải mã hình ảnh, âm thanh
ThirdParty/
  zstd/                   Thư viện nén Zstandard 1.5.7 (BSD / GPLv2)
  g722/                   Bộ giải mã âm thanh G.722 của WebRTC
Tests/                    Unit test
scripts/                  Script đóng gói app và tạo file DMG

Mọi issue và pull request đều được chào đón. Trước khi gửi PR, bạn vui lòng:

1. Chạy swift test và đảm bảo không có test nào lỗi.
2. Nếu thêm chữ mới trên giao diện, thêm vào cả en.lproj và vi.lproj.
3. Không commit mật khẩu, ID đối tác, token hay file cài đặt của UltraViewer.

MacViewer không thu thập bất kỳ dữ liệu nào. Khi kiểm tra bản cập nhật, ứng dụng chỉ đọc thông tin phiên bản công khai trên GitHub (có thể tắt trong Cài đặt). Mật khẩu chỉ được lưu khi bạn chọn ghi nhớ, và chỉ lưu trong Keychain của macOS. Lịch sử kết nối chỉ lưu ID, không bao giờ lưu mật khẩu.

MacViewer phát hành theo giấy phép MIT.

Các thư viện bên thứ ba vẫn giữ giấy phép riêng của chúng, xem THIRD_PARTY_NOTICES.md. File 8bit.dat là dữ liệu lấy từ UltraViewer và không thuộc giấy phép MIT.

UltraViewer là thương hiệu của chủ sở hữu tương ứng, chỉ được nhắc đến ở đây để nói rõ khả năng tương thích.