macOS インストールガイド

このガイドでは、macOS システムに Sokuji をインストールする方法を説明します。Sokuji は署名済みで Apple の公証を受けた .pkg インストーラーとして提供され、高度なオーディオ処理機能のための仮想オーディオドライバーが含まれています。

インストール手順

公式 GitHub リリースページにアクセスして、macOS 用の Sokuji の最新バージョンをダウンロードします。

ヒント：どちらをダウンロードすべきかわからない場合は、Apple メニュー（）→「この Mac について」でチップの種類を確認してください。「Apple M1/M2/M3/M4」と表示される場合は arm64 版を、「Intel」と表示される場合は x64 版を選択してください。

バージョン 0.46.5 以降、PKG インストーラーは署名と公証を受けているため、macOS は追加の手順なしで開けます。

Sokuji とその仮想オーディオドライバーをインストールします。

ダウンロードフォルダーでダウンロードした .pkg ファイルを見つけます（例：Sokuji-x.x.x-arm64.pkg または Sokuji-x.x.x-x64.pkg）
PKG ファイルをダブルクリックしてインストールを開始します
macOS インストーラーが開きます - 「続ける」をクリックして進みます
インストールの詳細を確認し、「インストール」をクリックします
プロンプトが表示されたら管理者パスワードを入力します（ドライバーのインストールに必要）
インストールが完了するまで待ちます（通常 1〜2 分）
インストールが完了したら「閉じる」をクリックします

Sokuji.app - /Applications にインストールされます
SokujiVirtualAudio.driver - /Library/Audio/Plug-Ins/HAL にインストールされる仮想オーディオドライバー
インストーラーは自動的に CoreAudio を再起動してドライバーをロードします

管理者パスワードが必要なのは、インストーラーがシステムレベルのオーディオドライバーをインストールする必要があるためです。仮想オーディオドライバーは高度なオーディオ処理機能を有効にします。

アプリケーションフォルダから Sokuji を開きます。セキュリティの回避手順は必要ありません。

Sokuji が実行されているので、初回使用の設定を行いましょう：

macOS がプロンプトを表示したらマイクの権限を付与します
希望のインターフェース言語を選択します
AI プロバイダー（OpenAI、Google Gemini など）を選択します
選択したプロバイダーの API キーを入力します
翻訳のソース言語とターゲット言語を選択します
マイクを選択し、音声ブロックで既定の再生デバイスにスピーカーまたはヘッドフォンを選びます。Sokuji 自身の仮想オーディオデバイスはここには表示されません。相手に聞こえる翻訳が翻訳をそのデバイス、つまり会議アプリで選ぶ仮想マイクに送ります
マイクとスピーカーの設定をテストします

おめでとうございます！Sokuji の準備が整いました。仮想オーディオドライバーがインストールされ、オーディオデバイスリストで利用できます。マイクボタンをクリックしてリアルタイム翻訳を開始してください。

Sokuji がマイクにアクセスできない場合：

翻訳された音声が聞こえない場合：

システム環境設定 → サウンド → 出力を開きます
希望の出力デバイスを選択します
出力音量がミュートされていないことを確認します
Sokuji の音声ブロックで、聞きたい行のデバイスを確認します：自分の翻訳は自分にも再生（既定ではオフ）、相手の翻訳は自分に聞こえる翻訳、それ以外の音は既定の再生デバイス

お使いの Mac に合った正しいインストーラーをダウンロードしたか確認してください：

オーディオデバイスに「SokujiVirtualAudio」が表示されない場合：

まず Sokuji に修復させます：ドライバーはインストールされているのに macOS に読み込まれていない場合、Sokuji は起動時にその旨を知らせて修復を提案します。管理者パスワードを入力すると、Sokuji が Core Audio を再起動してドライバーを読み込みます。Sokuji の再起動は不要です
ドライバーがインストールされているか確認します：ls /Library/Audio/Plug-Ins/HAL/
存在しない場合は、Sokuji を再インストールする必要がある可能性があります
存在していて修復でも直らない場合は、CoreAudio を再起動してみてください：sudo killall coreaudiod。または Mac を再起動します
システム設定 → サウンドでデバイスが表示されるか確認します

これは正常で必要です：