Lispr を最大限に使いこなす。

1. マイク

Lispr はあなたの声を聞く必要があります。macOS は初回にプロンプトを出します。プロンプトを見逃したり権限を取り消してしまった場合は、システム設定 → プライバシーとセキュリティ → マイク で許可してください — Lispr をオンにします。

2. アクセシビリティ

Lispr は認識したテキストをカーソルの位置に挿入します — これにはアクセシビリティの権限が必要です。システム設定 → プライバシーとセキュリティ → アクセシビリティ で許可してください — Lispr をオンにします。

3. Input Monitoring（macOS 10.15+ のみ）

Lispr が別のアプリにフォーカスがある状態でもトリガーキーの押下を聞き取れるようにするためです。システム設定 → プライバシーとセキュリティ → Input Monitoring で許可してください。Lispr は 0.33 以降、IOHIDRequestAccess 経由で適切に要求します。

押して話す

右の ⌥ キーを押し続けて、話して、離します。テキストはどのアプリでもカーソル位置に現れます。それだけです — ウェイクワードなし、リスニングモードなし、設定なし。

ラッチ（ハンズフリー）モード

トリガーキーをダブルタップすると、Lispr は再度タップするまで録音を続けます。両手を空けたいときに便利です。

録音中にキャンセル

録音中に Esc を押すと、話した内容を破棄します — 何も書き起こされず、何も挿入されません。

代替トリガーキー

右の ⌥ が Mac の他のショートカットに取られている場合、Lispr は Fn キーも push-to-talk トリガーとしてサポートします。

言語

Lispr は多言語対応の Whisper 経由で書き起こします。言語は自動検出されます — 文の途中で切り替えてもついてきます。約 99 の言語が認識され、セットアップは不要です。

スマートな文の結合

ひとつのフレーズを口述したあと、すぐにもう一度口述すると、Lispr は両者の間に句点とスペースを挿入します — つながった文章にはなりません。自動結合は Lispr 自身の前回の挿入の直後にのみ起きるので、あなたが自分でタイプしたテキストには触れません。

クリップボード

Lispr は内部的にクリップボードを使ってテキストを挿入しますが、直後にあなたがコピーしていた内容を復元します。⌘V は依然として 1 時間前にコピーしたリンクや段落を返してくれます。

アップデート

Lispr は Sparkle 経由で自動更新します — 新しいリリースが署名されると、インストール済みの Lispr が次回起動時にそれを提示します。各バージョンで何が変わったかは changelog をご覧ください。

トリガーキーが反応しない

• Input Monitoring が許可されていることを確認してください（上記ステップ 3）— これがないと Lispr はバックグラウンドのアプリからのキー押下を見ることができません。
• 他のアプリが右の ⌥ を奪っていないか確認してください — Karabiner、BetterTouchTool、Raycast ホットキー、Magnet など。もし奪われているなら、メニューバーアイコンから Lispr を Fn に切り替えてください。

「うまく聞き取れませんでした」

Lispr は非常に短い録音や無音の録音をフィルタリングします（0.39 以降）— このうち約 10 件中 9 件は短い無音で、聞き逃した言葉ではありませんでした。これが出てしかも実際に 話した 場合は、話し始める前に少し長めにキーを押し続け、メニューバーアイコンで正しい入力デバイスが選ばれているか確認してください。

テキストが間違ったアプリに入る

Lispr はトリガーキーを 離した 瞬間にフォーカスされているカーソルに挿入します。録音中にアプリを切り替えると、テキストは新しいアプリに入ります。コツ：キーを押す前にカーソルを目的地に置いてください。

メニューバーアイコンが見当たらない

• 特に macOS 11–12 では、以前のビルド（≤ 0.24）がアイコンを失うことがありました — changelog ページから最新版に更新してください。これは 0.25 で修正されました。
• 最近の macOS でそれでも見えない場合：メニューバーがいっぱいで、アイコンが Control Center / Bartender の下に隠れている可能性があります。いくつかアイコンを隠してメニューバーを広げてみてください。

書き起こしのタイムアウト

ネットワークが瞬断すると、Lispr は 10 秒で諦めて（0.34 以降）、親切なメッセージを表示します。もう一度試してください — Lispr は一時的な失敗時にも自動でリトライする（0.31 以降）ので、次のリクエストはしばしば成功します。

Sparkle がアップデートを取得できない

DMG と appcast は proxy.lispr.ai から TCP-only 経路で配信されます（0.39 以降）— これにより、一部のネットワークが抱える HTTP/3 の問題を回避します。それでもネットワークがブロックする場合は、いつでも最新の Lispr.dmg を lispr.ai から直接ダウンロードし、アプリを手動で置き換えられます。

10 分の録音上限

Lispr は 1 回の録音を 10 分で停止し、ローカライズされた警告を表示します（0.37 以降）— これは偶発的なマラソン録音が通らないようにするためのソフトな上限です。長い口述には、いったん離してから新しい録音を始めてください。

私の声はどこへ行きますか？

あなたの Mac から暗号化された接続で、私たちが運用するエッジプロキシに送られ、そこから Groq へ書き起こしのために転送されます。Groq はテキストを返し、プロキシはそれをあなたの Mac に返し、音声は直ちに破棄されます。サーバーに何も保存されません。何もモデルの学習には使われません。

アカウントはありますか？

ありません。サインアップなし、パスワードなし、プロフィールなし。ログインする場所がないのは、そもそもログインする場所がないからです。

ログはどうですか？

0.40 以降、何かうまくいかなかった際に、Lispr は診断用の X-Lispr-* ヘッダーを送信できます — これはヘッダー（タイミングやエラーコード）であり、音声でも書き起こしでもなく、サーバー側で保持していません。

オフラインで動きますか？

いいえ — 書き起こしはクラウドで動作します。だからこそ高速（0.41 以降、エンドツーエンドで中央値 ~300 ms）で、かつ正確なのです。完全にローカルな口述が必要な場合は、macOS 標準の音声入力がまっとうな選択肢です。これは速度と言語カバレッジのために私たちが選んだトレードオフです。