トラブル解決Mac11 分で読めます
VoiceInk で文字起こしできないときの原因の切り分け
VoiceInk で文字起こしできないときは、公式の診断手順に沿って、マイクの取り込み、Mode とモデル、貼り付けの段階を順番に確認します。
Petal の開発元、Optimal Apps が公開しています。
このページの内容
VoiceInk で文字起こしできない場合、失敗しているのは、マイクの取り込み、モデル、貼り付けの 3 つの段階のどれかです。VoiceInk の公式ガイド「Transcription Failing or No Output」も、この順番で確認します。まず 「システム設定」>「プライバシーとセキュリティ」 で マイク と アクセシビリティ を確認し、VoiceInk を再起動します。次に VoiceInk のサイドバーで Audio を開き、入力を確認します。そのあと、使用中の Mode に有効な文字起こしモデルがあり、そのモデルが AI Models でダウンロードされていることを確認します。VoiceInk にはテキストが表示されるのに使いたいアプリに表示されない場合は、貼り付けの段階に問題があります。
すぐに試せるチェックリスト
| 症状 | 失敗している段階 | 対処法 |
|---|---|---|
| 録音画面に音声レベルが表示されない | 取り込み | Audio でマイクを選び、「サウンド」>「入力」を確認する |
| 許可を変更したあと何も出力されない | 取り込み | VoiceInk を再起動する |
| 新しいマイクが一覧にない | 取り込み | Refresh Microphones をクリックする |
| Mode で結果が出ない | モデル | Mode を有効にし、有効なモデルを選ぶ |
| ローカルモデルで何も出ない | モデル | AI Models でダウンロードし、読み込んだ .bin ファイルを確認する |
| クラウドモデルで失敗する | モデル | API キーとネットワークを確認する |
| VoiceInk にはテキストが出るが、アプリには出ない | 貼り付け | 貼り付けのガイドに従う |
| テキストはあるが、内容が間違っている | モデル | 別のモデルを試し、Vocabulary に追加する |
ステップ 1:VoiceInk で文字起こしできない原因を 3 つの段階で切り分ける
設定を変える前に、一度テストします。
- 「テキストエディット」を開き、新規書類をクリックします。
- VoiceInk のショートカットを使い、はっきりと文を 1 つ話します。
- 話している間は録音画面を見て、そのあと VoiceInk の履歴で結果を確認します。
失敗している段階を特定します。
- 音声レベルが動かない。 取り込みの段階で失敗しています。ステップ 2 に進んでください。
- レベルは動くが、VoiceInk にテキストがない。 モデルの段階で失敗しています。ステップ 4 に進んでください。
- VoiceInk にはテキストが表示されるが、「テキストエディット」は空。 貼り付けの段階で失敗しています。ステップ 6 に進んでください。
ステップ 2:許可を確認する
VoiceInk のドキュメントでは、3 つの許可を挙げています。
- マイク は録音に必要です。
- アクセシビリティ は、確実な貼り付けと、選択したテキストを文脈として使うために必要です。
- 画面収録 は、Mode で画面の内容を文脈として使う場合にだけ必要です。
- 「システム設定」>「プライバシーとセキュリティ」>「マイク」 を開き、VoiceInk がオンになっていることを確認します。
- 「システム設定」>「プライバシーとセキュリティ」>「アクセシビリティ」 を開き、VoiceInk がオンになっていることを確認します。
- 何かを変更したら、VoiceInk を再起動します。VoiceInk のドキュメントでは、この手順が必要だとしています。
ソースから VoiceInk をビルドした場合や、新しいビルドをインストールした場合は、 スイッチが「オン」と表示されていても失敗することがあります。macOS はアクセシビリティの許可をアプリのコード署名に結び付けていて、新しい署名は古い許可と一致しないからです。VoiceInk の GitHub issue #530 に対処法があります。「ターミナル」で tccutil reset Accessibility com.prakashjoshipax.VoiceInk を実行し、VoiceInk を開き直して、もう一度アクセシビリティを許可してください。
一般的な手順は、Mac のマイクの許可 を参照してください。
ステップ 3:音声の入力を確認する
- VoiceInk のサイドバーで Audio を開きます。
- Selected Microphone で 1 つのデバイスを選びます。または Priority Order を使うと、あるデバイスが見つからないときに、VoiceInk が複数のデバイスを順番に試します。
- 新しいデバイスを接続したばかりの場合は、Refresh Microphones をクリックします。
- 「システム設定」>「サウンド」>「入力」 を開いて話し、同じデバイスの入力レベルが動くことを確認します。
この手順が効く理由: VoiceInk は、自分で選択しているデバイスから録音します。そのデバイスが外れている、スリープしている、ミュートされている場合、モデルには無音しか届かず、何も返ってきません。
VoiceInk は、ワイヤレスヘッドセットのマイクではなく、Mac の内蔵マイクか専用の外部マイクを使うことを勧めています。Bluetooth ヘッドセットは、マイクを使うときに低音質のモードに切り替わることが多いからです。Mac で Bluetooth マイクを使って音声入力する を参照してください。
また、未解決の報告(GitHub issue #916)もあります。ある環境では VoiceInk が完全に無音の音声を保存し、macOS の音声入力を同時に動かしているときだけ正しく録音できたというものです。「サウンド」設定ではレベルメーターが動くのに VoiceInk が無音を録音する場合は、報告するときにこの issue に触れてください。
ステップ 4:使用中の Mode を確認する
Mode は、VoiceInk が使うモデルと出力を決めます。設定の正しくない Mode は、「何も出力されない」原因としてよくあるものです。
- サイドバーで Modes を開きます。
- 使っている Mode が 有効 になっていることを確認します。
- 有効な文字起こしモデル が設定され、そのサービスまたはローカルモデルが使える状態であることを確認します。
- 言語 の設定が、話している言語と一致していることを確認します。日本語で話す場合は、日本語に対応したモデルと言語を選んでください。
- 出力の種類 を確認します。Paste はテキストを挿入し、Respond は録音画面に回答を表示し、Custom Command はテキストをコマンドに送ります。出力が Respond の場合、仕様としてアプリにはテキストが入りません。
ステップ 5:VoiceInk でモデルを読み込めないときの対処法
AI Models を開き、Mode が使っているモデルを確認します。
ローカルモデル
- モデルが ダウンロード されていることを確認します。
- 読み込んだ Whisper の
.binファイルの場合は、そのファイルが残っていて読み込めることを確認します。移動または削除した場合は、もう一度読み込んでください。 - ストリーミング専用のモデル には Real-time モードが必要です。読み込んだファイルには、バッチ処理に対応したモデルが必要です。
- Apple Speech には、macOS 26 以降と、その言語のアセットのインストールが必要です。
- VoiceInk Refine による補正には、Apple シリコン、16 GB 以上の RAM、ダウンロード済みの Refine モデルが必要です。
VoiceInk のドキュメントによると、Intel Mac ではローカルモデルが遅いので、通常はクラウドの文字起こしのほうがうまく動きます。モデルが遅いと、何も出力されないように見えることがあります。
クラウドのサービス
- API キー が設定されていて、そのサービスが文字起こしに対応していることを確認します。
- カスタムモデル の場合は、エンドポイントのパス、API キー、モデル名を確認します。VoiceInk によると、保存しても接続はテストされないので、入力ミスは文字起こしのときに初めて失敗としてわかります。
- ネットワークを確認します。GitHub issue #1010 では、会社のネットワークを使っているユーザーに文字起こしのエラーが出ました。原因は、誤って選択されていたクラウドモデルでした。ローカルモデルをダウンロードし、Mode に設定することで解決しました。
ステップ 6:貼り付けの問題を切り分ける
VoiceInk には文字起こしが表示されるのに使いたいアプリが空のままの場合、文字起こしは成功していて、貼り付けに失敗しています。VoiceInk のクリップボードのガイドでは、次の手順を案内しています。
- Mode が Paste の出力を使っていることを確認します。
- 録音する前に、貼り付け先の入力欄をクリックします。
- アクセシビリティを確認します(ステップ 2)。
- Settings > Pasting を開き、Paste Method を Default から AppleScript に変更します。
- 前のクリップボードの内容が貼り付けられる場合は、Restore Delay を長くします。初期設定は 2 秒で、250 ms から 5 秒まで設定できます。
詳しい手順は VoiceInk で貼り付けられないとき にあります。
ステップ 7:テキストがないのではなく、内容が間違っている場合
VoiceInk が文字起こしはするものの、テキストに誤りがある場合:
- Mode で別のモデルを試します。VoiceInk のドキュメントでは、対応する Mac でローカルの音声入力をすばやく行うには Parakeet V3 を勧めています。
- 決まった修正は Word Replacements に、大切な名前は Vocabulary に追加します。
- マイクに近づき、周囲の雑音を減らします。
ステップ 8:診断情報を集める
どの手順でも解決しない場合は、VoiceInk の Diagnostics and Support を使って、システム情報を集めるか、ログを書き出します。共有する前にログの内容を確認してから、VoiceInk の GitHub かサポートに問題を報告してください。
Petal:デバイス上のモデルを使う、無料の署名済みビルド
VoiceInk のソースは GPL v3 で、自分でビルドすれば無料で使えます。署名済みですぐに使えるビルドは、買い切りの有料ライセンスです。署名済みですぐに使えるビルドを無料で使いたい場合は、Petal for Mac という選択肢があります。このサイトを運営する Optimal Apps が提供する、無料でオープンソース(MIT)のアプリです。GitHub Releases のダウンロードは Developer ID で署名され、Sparkle でアップデートされるので、リリースが変わっても macOS の許可は同じ署名に結び付いたままになります。
Petal の 3 つの段階は次のとおりです。
- 取り込み。 Settings > Recording > Microphone でデバイスを選ぶか、Default のままにしてシステムの設定に従います。
- モデル。 Settings > Models で音声モデルをダウンロードします。Parakeet 110M は、軽量な英語向けのおすすめモデルです。Parakeet 0.6B V3 はヨーロッパの 25 言語、Whisper Large V3 Turbo は 99 言語に対応し、Apple Speech はダウンロード不要です。どれも Mac 上で動きます。Petal は初期設定のモデルに必要な RAM を 8 GB 未満に抑えています。
- 貼り付け。 Petal は手前のアプリに貼り付け、700 ms 後にクリップボードを戻すので、動作の遅い Electron アプリでも正しいテキストが入ります。アクセシビリティがオフの場合、Petal は代わりに文字起こしをコピーします。
各録音と文字起こしは History に保存され、Transcribe Again で保存した音声をもう一度処理できます。Petal W1 による整形も Mac 上で動きます。Petal には macOS 26.2 以降が必要です。
詳しい比較は Petal と VoiceInk の比較 または VoiceInk の代替アプリ を参照してください。
まとめ
- 一度テストして、取り込み、モデル、貼り付けのどの段階で失敗しているかを確認します。
- マイクとアクセシビリティの許可を確認し、VoiceInk を再起動します。
- ビルドし直したあとは、
tccutilでアクセシビリティの許可をリセットします。 - Audio でマイクを選び、「サウンド」設定でレベルを確認します。
- Mode が有効で、有効なモデルがあり、Paste の出力を使っていることを確認します。
- モデルがダウンロードされていること、またはクラウドのキーとネットワークが使えることを確認します。
- VoiceInk にはテキストが出るのにアプリには出ない場合は、貼り付けの段階を直します。
よくある質問
VoiceInk で何も文字起こしされないのはなぜですか?
VoiceInk のドキュメントでは、よくある原因を 5 つ挙げています。macOS の許可がない、マイクが正しくない、Mode の設定が想定と違う、ローカルモデルが Mac にとって遅すぎる、貼り付け先のアプリで貼り付けのタイミングが合わない、の 5 つです。この順番で確認してください。
ローカルモデルを使うと VoiceInk で何も出力されないのはなぜですか?
AI Models でモデルがダウンロードされ、使用中の Mode で選択されていることを確認してください。読み込んだ Whisper の .bin ファイルの場合は、そのファイルが残っていて読み込めることを確認してください。ストリーミング専用のモデルには Real-time モードが必要です。
VoiceInk はインターネット接続が必要ですか?
ローカルモデルをダウンロードしていれば不要です。クラウドの文字起こしサービスには、インターネットと有効な API キーが必要です。会社のネットワークで文字起こしに失敗する場合は、Mode で誤ってクラウドモデルを使っていないかを確認してください。
署名済みで無料の VoiceInk 代替アプリはありますか?
Petal for Mac は無料でオープンソースで、GitHub のリリースは署名済みのビルドです。Parakeet、Whisper、Qwen3 ASR などの音声モデルを Mac 上で動かします。