Bắt đầu

Cài đặt trên macOS

Từ lúc tải file đến khi app nghe được âm thanh trên máy chỉ mất vài phút. App đã được ký và notarize, macOS sẽ mở mà không cảnh báo bảo mật.

Sắp ra mắt

MiuWave chưa phát hành. Các bước dưới đây mô tả bộ cài sắp tới.

Yêu cầu

macOS 13 trở lên, Apple Silicon hoặc Intel. Engine Local MLX cần Apple Silicon (M1 trở lên) và khoảng 5 GB ổ đĩa.
Ít nhất một engine dùng được. Phổ biến nhất là Soniox (cần API key, ~$0.12/giờ). Không muốn dùng key: chọn Local MLX (Apple Silicon) hoặc SenseVoice (mọi Mac, tải model ~163 MB một lần). Xem Chọn engine dịch.

Các bước cài đặt

Tải file .dmg Từ trang phát hành, chọn MiuWave_<ver>_aarch64.dmg cho Apple Silicon (M1/M2/M3/M4) hoặc MiuWave_<ver>_x64.dmg cho Mac Intel.
Kéo vào Applications Mở file .dmg, kéo MiuWave vào thư mục Applications, rồi eject ổ DMG.
Mở app lần đầu Mở MiuWave từ Applications. Lần đầu mở, app hỏi bạn chọn chế độ dịch, rồi một hướng dẫn ngắn trong app chỉ qua các nút chính.
Cấp quyền cho macOS Bật các quyền ở mục Quyền cần cấp bên dưới. Quyền ghi màn hình là bắt buộc để nghe âm thanh hệ thống.
Nhập API key và bắt đầu Mở Cài đặt (⌘ ,) → Engine dịch, dán key và bấm Test. Xem Lấy API key, rồi làm theo Bắt đầu nhanh.

Quyền cần cấp

Quyền của macOS	Dùng cho	Khi nào cần
Screen & System Audio Recording (Ghi màn hình và âm thanh hệ thống)	Bắt âm thanh hệ thống (YouTube, Zoom, podcast…) và Chụp màn hình để dịch (`F3`)	Bắt buộc khi nghe nguồn Hệ thống hoặc Cả hai
Microphone	Nghe giọng nói qua micro	Khi chọn nguồn Mic hoặc Cả hai
Accessibility (Trợ năng)	Dịch nhanh (`F2`) sao chép chữ đang bôi đen	Chỉ khi dùng Dịch nhanh với chữ đang bôi đen

Ghi màn hình và âm thanh hệ thống

Khi macOS hỏi, bấm Open System Settings.
Tìm MiuWave trong danh sách và bật công tắc.
macOS yêu cầu Quit & Reopen — bấm nút đó để mở lại app.

Nếu bạn dùng F3 khi chưa có quyền, macOS hỏi ở lần đầu và app hiện thông báo “Cần quyền Ghi màn hình…” kèm nút Mở cài đặt. Bật MiuWave rồi mở lại app.

Micro

macOS hỏi quyền micro khi bạn bắt đầu nghe từ nguồn Mic hoặc Cả hai. Chọn cho phép. Mac mini không có micro tích hợp, hãy cắm micro ngoài (USB, tai nghe, AirPods).

Trợ năng (Accessibility) cho Dịch nhanh

Dịch nhanh sao chép chữ đang bôi đen bằng cách gửi phím tắt copy tới app đang mở, nên cần quyền Trợ năng. Khi chưa có quyền, cửa sổ Dịch nhanh hiện “Cho phép MiuWave sao chép chữ đang bôi đen: bật MiuWave trong Trợ năng (Accessibility)” và dịch nội dung clipboard thay thế.

Bấm Mở cài đặt (hoặc vào Cài đặt hệ thống → Quyền riêng tư và bảo mật → Trợ năng) rồi bật MiuWave. Clipboard của bạn được trả lại sau mỗi lần sao chép.

Lấy API key

Bạn chỉ cần key của engine định dùng. Key được lưu trong macOS Keychain.

Soniox (khuyên dùng)

Vào console.soniox.com và tạo tài khoản.
Chọn Billing, thêm phương thức thanh toán và nạp tiền (tối thiểu $10 — khoảng 80 giờ với ~$0.12/giờ).
Chọn API Keys → Create API Key và sao chép key.
Trong MiuWave: Cài đặt → Engine dịch → ô Soniox API Key, dán key rồi bấm Test.

OpenAI (tuỳ chọn)

Vào platform.openai.com, tạo tài khoản.
Settings → Billing: thêm phương thức thanh toán và nạp credit ($10 ≈ 2,5 giờ OpenAI Realtime).
API keys → Create new secret key, sao chép key (bắt đầu bằng sk-).

Chi phí

OpenAI Realtime khoảng $4/giờ, đắt hơn Soniox khoảng 34 lần. Hợp với cuộc họp quan trọng; dùng hằng ngày, Soniox vẫn là lựa chọn tốt hơn.

Qwen LiveTranslate Flash (tuỳ chọn, miễn phí preview)

Mở bailian.console.alibabacloud.com (Alibaba Cloud Model Studio).
Trước khi đăng nhập, chọn vùng Singapore ở góc trên bên phải. Key tạo ở vùng khác sẽ bị từ chối và app báo WebSocket error.
Kích hoạt Model Studio (DashScope) nếu được nhắc, vào API Keys → Create API Key.
Sao chép key ngay (chỉ hiện đầy đủ một lần) và dán vào ô Qwen (DashScope) API Key.

Không dùng key

Local MLX (Apple Silicon) tự cài môi trường và model (~5 GB) lần đầu bạn chọn nó. SenseVoice tải model ~163 MB một lần. Xem Chọn engine dịch.

Phím tắt trên macOS

Phím	Chức năng
`⌘` `↩`	Bắt đầu / Dừng
`⌘` `,`	Mở Cài đặt
`Esc`	Đóng Cài đặt
`⌘` `1` / `2` / `3`	Nguồn âm thanh Hệ thống / Mic / Cả hai
`⌘` `T`	Bật/tắt đọc bản dịch (TTS)
`⌘` `P`	Ghim cửa sổ nổi trên các cửa sổ khác
`⌘` `⇧` `L`	Tắt Bấm xuyên qua
`F2` · `F3`	Dịch nhanh · Chụp màn hình để dịch (đổi được trong Cài đặt → Dịch nhanh)

Cập nhật

MiuWave tự kiểm tra bản mới. Khi có, một chấm báo hiện trên nút Cài đặt; mở Cài đặt → Giới thiệu và bấm Download & Install. App tự khởi động lại với bản mới, bạn không cần tải lại file DMG.