Get started
Install on Windows
MiuWave runs on Windows 10 and 11. The installer is not code-signed yet, so SmartScreen asks on the first run — this is expected.
MiuWave is not released yet. The steps below describe the upcoming installer.
Requirements
- Windows 10 or later.
- WebView2 Runtime (usually already present on Windows 10/11).
- A working engine: Soniox (API key, ~$0.12/hour), OpenAI Realtime (API key, ~$4/hour) or SenseVoice — the offline engine on Windows, no key needed for speech recognition, one-time model download of ~163 MB. Local MLX runs only on Apple Silicon Macs.
Installation steps
- Download the installer
From the release page, download
MiuWave_<ver>_x64-setup.exe. - Allow it through SmartScreen When you see the Windows protected your PC screen, click More info, then Run anyway.
- Run the installer Click Next, keep the default install folder, and click Next until it finishes. Tick Run MiuWave and click Finish.
- Choose a translation mode and take the tour On first launch the app asks you to choose a translation mode, then a short in-app tour walks you through the main buttons.
- Enter an API key and start Open Cài đặt (Settings, Ctrl ,) → Engine dịch (Translation engine), paste your key and click Test. Getting a key works the same as on macOS: see Get an API key. Then follow Quick start.
The Hệ thống (System) source captures everything playing on your PC (via WASAPI) without installing a virtual cable. The Mic source listens to the microphone; Cả hai (Both) mixes the two. Keys are stored in Windows Credential Manager.
OCR language packs for screenshot translation
Chụp màn hình để dịch (Screenshot to translate; F3, or ⋯ → Chụp màn hình để dịch) uses the OCR built into Windows, so it can only read languages whose OCR pack is installed. When a pack is missing, the app says “Windows chưa có gói OCR cho ngôn ngữ này…” (Windows has no OCR pack for this language). To add one:
- Open Windows Settings → Time & Language → Language & region.
- Click Add a language and choose the language you need to read (for example Japanese).
- Make sure Optical character recognition is ticked in the optional features, then install.
- Capture again.
The OCR language follows the source language; you can set it separately in Cài đặt (Settings) → Dịch nhanh (Quick Translate) → Ngôn ngữ chữ trong ảnh (Text language in image).
Keyboard shortcuts on Windows
| Keys | Action |
|---|---|
| Ctrl Enter | Start / Stop |
| Ctrl , | Open Settings |
| Esc | Close Settings |
| Ctrl 1 / 2 / 3 | Audio source System / Mic / Both |
| Ctrl T | Turn reading translations aloud (TTS) on/off |
| Ctrl P | Pin the window on top of other windows |
| Ctrl Shift L | Turn off click-through |
| F2 · F3 | Quick Translate · Screenshot translation (change them in Settings → Quick Translate) |
Updates
When a new version is available, a dot appears on the Cài đặt (Settings) button. Open Cài đặt → Giới thiệu (About) and click Download & Install; the app restarts on its own, with no need to download the installer manually.