音声入力する

プッシュ・トゥ・トークキーを押して、話して、離します。文字起こしはキーを離したあとに発話全体に対して実行され、テキストは最前面のアプリに挿入されます。

プッシュ・トゥ・トークキー

設定 › Push-to-talk hotkey："Hold this key to dictate; release to insert."（このキーを押しながら話し、離すと挿入します）。変更はすぐに反映されます。

• Fn / Globe
• 左 ⌘
• 右 ⌘（既定）
• 左 ⌥
• 右 ⌥

長押しかタップ

• キーを押すと、すぐに録音が始まります。
• 400 ms 以上たってから離す：長押しで話すモード。録音が止まり、テキストが挿入されます。
• 400 ms 未満で離す：タップ。録音は続きます。2 回目のタップで停止して挿入します。
• Esc は進行中の録音をキャンセルします。何も挿入されません。
• 1 回の発話は 300 秒（5 分）が上限で、そこで自動的に停止して挿入します。

ピル

ピルは、メイン画面の下端から 96 pt 上、下部中央に常に表示される小さなパネルで、クリックはそのまま下のアプリへ通ります。すべてのスペースに表示され、フォーカスを奪うことはありません。

• 待機中：マイクのアイコン。
• モデルのダウンロード中は "Downloading speech model… NN%"、失敗すると "Model download failed — reopen Keebye to retry"。
• 音声入力中は "Listening…" → "Transcribing…" → "Inserting…"。
• 約 2.6 秒だけ表示される短いメッセージ："Couldn't insert: <reason>"、"Text left on clipboard — paste manually"、"Dictation paused: secure input on (<App>)"。

テキストが挿入される仕組み

既定の Paste (fast)：Keebye はクリップボードの内容を控えたうえで、クリップボードマネージャーが無視する一時的なペーストボードアイテムとして書き起こしを書き込み、⌘V を合成します。250 ms 後、ペーストボードがまだ Keebye のものであれば、元のクリップボードを復元します。"Restore clipboard after paste" は既定でオンです。

Terminal.app、iTerm2、Warp、WezTerm、kitty では、ペーストが最大 2000 バイトのチャンクに分割され、50 ms の間隔を置いて送られます。

Typing (terminals / SSH / any layout)：Keebye は Unicode のキーストロークを 16 文字ずつ、4 ms 間隔で送り、クリップボードには触れません。キーボード配列に依存せず、SSH や tmux 越しでも動作します。タイピングが失敗した場合はテキストがクリップボードに残り、ピルに "Text left on clipboard — paste manually" と表示されます。

パスワード欄とセキュア入力

セキュア入力が有効な場合、またはフォーカス中の要素がパスワード欄の場合、Keebye はクリップボードに何も書き込まず、"Couldn't insert: Secure input is active (<App>) — dictation is blocked" または "Couldn't insert: A password field is focused — dictation is blocked" を表示します。こうした音声入力が履歴に保存されることはありません。また 5 秒ごとの確認により、セキュア入力が有効な間は "Dictation paused: secure input on (<App>)" という警告が表示されます。

ウォームなマイク

マイクのストリームは最初の音声入力で開始し、その後はアプリが動いている間ずっと動き続けます。そのため、一度使うと macOS のマイクインジケーターが点いたままになります。各発話の先頭には、直近 500 ms のプリロールが付け加えられます。セッション最初の音声入力ではストリーム開始の待ち時間が残る場合があり、その 500 ms のバッファより前に話した言葉は切れることがあります。音声は 16 kHz モノラルにリサンプリングされ、デバイスの変更は 1 秒以内に検出されます。