インストールと権限

インストールと権限が正しければ、グローバルホットキーと音声入力は安定して動きます。下図は 自動生成の UI プレビュー（HTML シーン + Releases 実ページ）です。必要なら public/screenshots/ の PNG を実写に差し替えできます。

要件

• macOS 14 以降
• Apple Silicon または Intel
• 任意: ASR / LLM の API キー（BYOK）
• 本番の音声入力には: マイク + アクセシビリティ
• Apple のシステム音声 を使う場合は追加で: システム設定 → プライバシーとセキュリティ → 音声認識

1. インストーラを入手する

1. Releases を開く
   VoiceHotkey-releases · Latest へ移動します。

2. DMG をダウンロード
   macOS 用の .dmg アセットを選びます。Source code アーカイブはアプリ本体ではありません。

3. ディスクイメージを開く
   DMG をダブルクリックし、インストールウィンドウが表示されるまで待ちます。

図 1 · Releases ページ（UI プレビュー · install-01-releases.webp）

2. 安定したパスにインストールする

1. アプリケーションにドラッグ
   VoiceHotkey.app を アプリケーション、または ~/Applications にドラッグします。

2. DMG を取り出す（任意）
   バックアップとして DMG を残しても構いません。

3. パスを覚えておく
   いつも 同じ 場所から起動してください。例:

   • /Applications/VoiceHotkey.app
   • または ~/Applications/VoiceHotkey.app

図 2 · DMG インストールウィンドウ（UI プレビュー · install-02-dmg.webp）

図 3 · アプリのパスを確認（UI プレビュー · install-03-path.webp）

ダウンロードフォルダから長期起動しない

~/Downloads や一時フォルダから起動すると、移動や再ダウンロードのたびに macOS が アクセシビリティ を別アプリ扱いし、ホットキーが「突然」効かなくなります。先にアプリケーションへ入れ、そのうえで権限を付与してください。

3. 初回起動

1. アプリを開く
   Launchpad または Finder から。Gatekeeper に止められた場合は プライバシーとセキュリティ で許可します（公証済みビルドの方がスムーズです）。

2. メニューバーを確認
   右側にマイク風のアイコンが出ます。見当たらないときはメニューバーのあふれ表示、またはアプリが終了していないかを確認してください。

3. オンボーディングを完了
   初回は クイックセットアップ（ようこそ → 権限 → プラン → 完了）が表示されます。権限はそこで付与しても、あとからシステム設定でも構いません。

図 4 · メニューバーアイコン（UI プレビュー · install-07-menubar.webp）

図 5 · オンボーディングの権限（UI プレビュー · install-06-onboarding.webp）

4. アクセシビリティを許可する

グローバルホットキー、キャレット位置への挿入、キー注入に必要です。無いとホットキーはほぼ反応しません。

1. システム設定 → プライバシーとセキュリティ → アクセシビリティ を開きます。
2. +（またはロック解除）で VoiceHotkey.app を追加します。
3. パスが実際に起動しているアプリと一致していることを確認します。
4. スイッチを オン にします。
5. 「VoiceHotkey」が複数行ある場合: 古い行を削除し、現在のパスだけ残してからアプリを 終了して再起動 します。

図 6 · アクセシビリティ（UI プレビュー · install-04-accessibility.webp）

アプリから開く

設定 → 一般（またはオンボーディング）には、アクセシビリティへジャンプするボタンがあります。許可後、メニューバーの「アクセシビリティが必要」警告は消えるはずです。

5. マイクを許可する

本番の音声入力に必須です。デモモードではマイクを省略できますが、実運用では必要です。

1. システム設定 → プライバシーとセキュリティ → マイク を開きます。
2. VoiceHotkey を有効にします。
3. 初回録音時にシステムダイアログが出たら許可します。
4. 外付けマイクは システム設定 → サウンド → 入力 で確認。アプリの 一般 にマイク選択がある場合は同じデバイスを使います。

5b. 音声認識（Apple エンジンのみ）

Apple Speech / SpeechAnalyzer を使う場合、システムは 音声認識 の権限も求めます（SFSpeechRecognizer）。クラウドエンジン（Doubao、Whisper など）は通常この権限に 依存しません。

1. システム設定 → プライバシーとセキュリティ → 音声認識 を開きます。
2. VoiceHotkey を許可します。
3. 言語が利用できない場合は、システム設定で言語パックをダウンロードするか、エンジンを変えてください。

図 7 · マイク（UI プレビュー · install-05-microphone.webp）

6. 権限チェックリスト

確認項目	期待する状態
メニューバーアイコン	表示され、メニューが開く
設定 → 一般 · 権限	アクセシビリティ + マイクが許可済み。Apple エンジン使用時は音声認識も許可済み
ホットキー押下	オーバーレイ / ステータスが変化（デモでも可）
インストールパス	アクセシビリティの登録と一致

まだ直らない場合は トラブルシューティング を参照してください。

次へ

初回セットアップデモモード、エンジン、ショートカット、本番の入力テスト。

ショートカットと録音タップ / 押し続け、Quick Send、キャンセル。