初回セットアップ

インストールと権限 が済んでいる前提です。破線の枠はスクリーンショット用プレースホルダ（public/screenshots/setup-*.svg）です。

概要

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

1. 設定を開く

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

図 1 · 設定（プレースホルダ · setup-01-settings.svg）

ディープリンク

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

2. デモモード

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

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

図 2 · 一般 · デモモード（プレースホルダ · setup-02-demo.svg）

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

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

3. 音声認識モデルを選ぶ

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

図 3 · 音声認識モデル（プレースホルダ · setup-03-models.svg）

いちばん早い経路

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

ローカルのみモード

ローカルのみ がオンのとき、公衆クラウドエンジンは失敗します。Apple / localhost を使うか、一時的にローカルのみをオフにしてください。

4. ホットキーを確認する

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

図 4 · ホットキー（プレースホルダ · setup-04-hotkeys.svg）

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

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

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

図 5 · テキスト後処理（プレースホルダ · setup-05-postprocess.svg）

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

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

図 6 · 音声入力を試す（プレースホルダ · setup-06-try.svg）

成功の基準

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

失敗したとき

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

セットアップ後

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

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

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