はじめに

macOS へのインストール

ファイルのダウンロードから、アプリがパソコンの音声を聞き取れるようになるまで数分しかかかりません。アプリは署名と公証（notarization）済みなので、macOS はセキュリティ警告なしで開きます。

近日公開

MiuWave はまだリリースされていません。以下の手順は今後提供されるインストーラーについての説明です。

動作要件

macOS 13 以降（Apple Silicon または Intel）。Local MLX エンジンには Apple Silicon（M1 以降）と約 5 GB の空き容量が必要です。
使用できるエンジンが 1 つ以上必要です。最も一般的なのは Soniox（API キーが必要、約 $0.12/時間）です。キーを使いたくない場合は、Local MLX（Apple Silicon）または SenseVoice（どの Mac でも可、初回のみ約 163 MB のモデルをダウンロード）を選んでください。エンジンの選び方をご覧ください。

インストール手順

.dmg ファイルをダウンロードする リリースページから、Apple Silicon（M1/M2/M3/M4）なら MiuWave_<ver>_aarch64.dmg、Intel Mac なら MiuWave_<ver>_x64.dmg を選びます。
アプリケーションフォルダーにドラッグする .dmg ファイルを開き、MiuWave をアプリケーションフォルダーにドラッグしてから、DMG を取り出します。
初めてアプリを開く アプリケーションフォルダーから MiuWave を開きます。初回起動時は翻訳モードの選択を求められ、続いてアプリ内の短いツアーで主なボタンを案内します。
macOS の権限を許可する 下の必要な権限にある権限をオンにします。システム音声を聞き取るには画面収録の権限が必須です。
API キーを入力して開始する Cài đặt（設定、⌘ ,）→ Engine dịch（翻訳エンジン）を開き、キーを貼り付けて Test をクリックします。API キーの取得を参照し、その後クイックスタートに進んでください。

必要な権限

macOS の権限	用途	必要になる場面
画面とシステムオーディオの録音	システム音声（YouTube、Zoom、ポッドキャストなど）の取り込みとスクリーンショット翻訳（`F3`）	Hệ thống（システム）または Cả hai（両方）のソースを聞くときは必須
マイク	マイクからの音声の聞き取り	Mic または Cả hai（両方）のソースを選んだとき
アクセシビリティ	クイック翻訳（`F2`）で選択中のテキストをコピーするため	選択したテキストにクイック翻訳を使うときのみ

画面とシステムオーディオの録音

macOS から確認されたら、“システム設定”を開くをクリックします。
一覧から MiuWave を探し、スイッチをオンにします。
macOS から終了して再度開くよう求められるので、クリックしてアプリを再起動します。

権限を許可する前に F3 を使うと、初回は macOS から確認があり、アプリには 「Cần quyền Ghi màn hình…」（画面収録の権限が必要です…）というメッセージと Mở cài đặt（設定を開く）ボタンが表示されます。MiuWave をオンにしてから、アプリを開き直してください。

マイク

Mic または Cả hai（両方）のソースで聞き取りを始めると、macOS がマイクへのアクセスを確認します。許可を選んでください。Mac mini にはマイクが内蔵されていないため、外部マイク（USB、ヘッドセット、AirPods）を接続してください。

クイック翻訳のためのアクセシビリティ

クイック翻訳は、前面のアプリにコピーのショートカットを送って選択中のテキストをコピーするため、アクセシビリティの権限が必要です。許可がない場合、クイック翻訳のウィンドウに 「Cho phép MiuWave sao chép chữ đang bôi đen: bật MiuWave trong Trợ năng (Accessibility)」（選択中のテキストを MiuWave がコピーできるよう、アクセシビリティで MiuWave をオンにしてください）と表示され、代わりにクリップボードの内容を翻訳します。

Mở cài đặt（設定を開く）をクリックするか、システム設定 → プライバシーとセキュリティ → アクセシビリティを開き、MiuWave をオンにします。クリップボードの内容は、コピーのたびに元に戻ります。

API キーの取得

キーが必要なのは、使う予定のエンジンの分だけです。キーは macOS のキーチェーンに保存されます。

Soniox（おすすめ）

console.soniox.com にアクセスしてアカウントを作成します。
Billing を選び、支払い方法を追加してチャージします（最低 $10、約 $0.12/時間で約 80 時間分）。
API Keys → Create API Key を選び、キーをコピーします。
MiuWave で Cài đặt（設定）→ Engine dịch（翻訳エンジン）→ Soniox API Key 欄にキーを貼り付け、Test をクリックします。

OpenAI（任意）

platform.openai.com にアクセスしてアカウントを作成します。
Settings → Billing：支払い方法を追加してクレジットを購入します（$10 で OpenAI Realtime 約 2.5 時間分）。
API keys → Create new secret key でキーを作成してコピーします（sk- で始まります）。

コスト

OpenAI Realtime は約 $4/時間で、Soniox の約 34 倍です。重要な会議には向いていますが、普段使いには Soniox の方がおすすめです。

Qwen LiveTranslate Flash（任意、無料プレビュー）

bailian.console.alibabacloud.com（Alibaba Cloud Model Studio）を開きます。
サインインする前に、右上で Singapore（シンガポール）リージョンを選びます。他のリージョンで作成したキーは拒否され、アプリに WebSocket error と表示されます。
求められたら Model Studio（DashScope）を有効化し、API Keys → Create API Key に進みます。
キーはすぐにコピーし（全体が表示されるのは 1 回だけです）、Qwen (DashScope) API Key 欄に貼り付けます。

キーなしで使う

Local MLX（Apple Silicon）は、初めて選んだときに実行環境とモデル（約 5 GB）をインストールします。SenseVoice は約 163 MB のモデルを 1 回だけダウンロードします。エンジンの選び方をご覧ください。

macOS のキーボードショートカット

キー	操作
`⌘` `↩`	開始／停止
`⌘` `,`	設定を開く
`Esc`	設定を閉じる
`⌘` `1` / `2` / `3`	音声ソースをシステム／マイク／両方に切り替え
`⌘` `T`	翻訳の読み上げ（TTS）のオン／オフ
`⌘` `P`	ウィンドウを他のウィンドウより手前に固定
`⌘` `⇧` `L`	クリックスルーをオフにする
`F2` · `F3`	クイック翻訳 · スクリーンショット翻訳（設定 → クイック翻訳で変更できます）

アップデート

MiuWave は新しいバージョンを自動で確認します。新しいバージョンがあると Cài đặt（設定）ボタンにドットが表示されます。Cài đặt → Giới thiệu（情報）を開き、Download & Install をクリックしてください。アプリが新しいバージョンで再起動するので、DMG を再ダウンロードする必要はありません。