初回セットアップ

インストールと権限 が済んでいる前提です。下図は設定デモから自動撮影した UI プレビューです（public/screenshots/setup-*.webp）。

概要

手順	場所	目的
1	メニューバー → 設定	メイン UI を開く
2	一般	本番入力のためデモモードをオフ
3	音声入力モデル	エンジンと、必要ならキーを設定
4	ショートカット	音声入力 ⌃⌥Space、コマンド ⌃⌥C の確認（変更可)
5	テキスト処理	空白 / 仕上げ（既定のままで可）
6	メモなど	端から端までのテスト

1. 設定を開く

1. VoiceHotkey のメニューバーアイコン をクリックします。
2. 設定 を選びます。
3. サイドバーのグループ:
   • アプリ: 一般、このアプリについて、ライセンス
   • 音声: ショートカット、音声入力モデル、テキスト処理、音声コマンド
   • ツール: ファイル転写、履歴

図 1 · 設定（UI プレビュー · setup-01-settings.webp）

ディープリンク

voicehotkey://tab/settings — ディープリンク を参照。

2. デモモード

デモモード はマイクを使わず、デモ用テキストで UI を試せます。本番の音声入力では オフ にしてください。

1. 設定 → 一般 を開きます。
2. デモモード を探します。
3. 本番入力の場合: オフにします。
4. メニューバーの状態がデモ / マイク未使用の表示でなくなっていることを確認し、マイクやエンジンの警告があれば続けて直します。

図 2 · 一般 · デモモード（UI プレビュー · setup-02-demo.webp）

デモをオンのままにするとき

UI 確認だけで録音しない場合。デモモードではファイル転写も実アップロードを省略することがあります。

3. 音声入力モデルを選ぶ

1. 設定 → 音声入力モデル を開きます。
2. エンジンを選びます。例:
   • Apple（オンデバイス。最初の成功経路に向く）
   • Doubao など（Free の制限は プラン を参照）
   • 百煉 / MiMo / OpenAI Speech / Groq / Soniox / NVIDIA…（Trial/Pro で複数エンジン）
3. クラウドエンジン: API キー を貼り付けます（キーチェーン に保存）。
4. 必要に応じてモデル ID、言語、文脈用語を入力します。
5. ページ上に「未設定」などのエラーが無いことを確認します。

図 3 · 音声入力モデル（UI プレビュー · setup-03-models.webp）

いちばん早い経路

Apple、またはすでにキーがあるクラウドエンジンから始めます。詳細: 音声入力モデル。

ローカルのみモード

ローカルのみ がオンのとき、公衆クラウドエンジンは失敗します。Apple、内蔵 4 オンデバイス（SenseVoice / Whisper Turbo / Fun-ASR-Nano / Parakeet）、または localhost を使うか、一時的にローカルのみをオフにしてください。

4. ショートカットを確認する

1. 設定 → ショートカット を開きます。
2. 音声入力 を確認 — 既定は多くの場合 ⌃⌥Space、音声コマンド は ⌃⌥C です。
3. タップ で録音のトグル、押し続け で話して離すと完了（トリガーモードによる）。
4. 衝突する場合は別の組み合わせを再録します。
5. 任意: あとから 音声コマンド、音声翻訳、直接音声入力（整形スキップ、既定は未割当）も割り当て可能。
6. アクセシビリティに関する警告が出る場合は インストールと権限 を完了してください。

図 4 · ショートカット（UI プレビュー · setup-04-hotkeys.webp）

Quick Send、Esc でのキャンセル、効果音などは主に 一般 にあります。ショートカットと録音 を参照。

5. テキスト処理（既定のままで可）

項目	初回
末尾の句点を削除	チャット向けに便利
スマート空白 / 段落	既定で問題なし
単語置換	固定の誤認識が出てから追加
LLM 仕上げ	LLM キーが必要。後回しで可
出力アクション	既定: キャレット位置に挿入
翻訳	別ホットキー + モデル

図 5 · テキスト処理（UI プレビュー · setup-05-postprocess.webp）

6. 端から端までのテスト

1. メモ や任意のテキスト欄を開き、クリックしてキャレットを点滅 させます。
2. 音声入力 ホットキーを押します（オーバーレイ / ステータスが変わるはず）。
3. 短い一文を話します。
4. もう一度タップするか、押し続けを離して完了します。
5. ASR（と任意の仕上げ）を待ち、キャレット位置にテキストが出ることを確認します。
6. 任意: 履歴 に新しいエントリがあるか確認します。

図 6 · 音声入力を試す（UI プレビュー · setup-06-try.webp）

成功の基準

• 録音中のフィードバックがある
• 離したあとテキストが出る
• テキストが フォーカス中 の欄に入る

失敗したとき

症状	参照先
ホットキーが無反応	トラブルシューティング · ホットキー
録音するがテキストなし	トラブルシューティング · テキストなし
権限がすぐ外れる	トラブルシューティング · 権限

セットアップ後

単語置換ブランド名や定型の ASR 誤認識を直す。

ローカルのみモード公衆インターネットを遮断する。

音声コマンド任意の音声ショートカット。