← ドキュメントに戻る

macOS インストールガイド

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

macOS版をダウンロード

システム要件

  • macOS 10.15 (Catalina) 以降
  • Apple Silicon (M1/M2/M3/M4) または Intel (x86_64) プロセッサ
  • 最小4GBのRAM(8GB推奨)
  • 200MBの空きディスク容量
  • 管理者権限(仮想オーディオドライバーのインストールに必要)
  • AI翻訳サービス用のインターネット接続
  • マイクとスピーカー/ヘッドフォン

インストール手順

ステップ 1:Sokuji をダウンロード

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

PKG インストーラーをダウンロード

  • Sokuji-x.x.x-arm64.pkg - Apple Silicon Mac (M1/M2/M3/M4) 用
  • Sokuji-x.x.x-x64.pkg - Intel Mac 用
  • 各インストーラーには Sokuji アプリと仮想オーディオドライバーが含まれています
  • ファイルサイズは約 150-200MB です

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

PKG インストーラーは署名されていないため、インストールするには特別な手順が必要です(次のステップで説明します)。

ステップ 2:インストールの準備

PKG インストーラーは署名されていないため、macOS はデフォルトでブロックします。インストール前に隔離属性を削除する必要があります。

隔離属性の削除(必須)

  1. ターミナルを開きます(アプリケーション → ユーティリティ → ターミナル)
  2. 次のコマンドを入力または貼り付けます(x.x.x をバージョン番号に置き換えてください):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Intel Mac の場合:sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Enter キーを押し、プロンプトが表示されたら管理者パスワードを入力します
  4. コマンドはサイレントで完了します(出力がないことは成功を意味します)

これは何をしますか?このコマンドは、macOS がダウンロードファイルに追加する隔離フラグを削除します。これは署名されていない PKG インストーラーにとって安全で必要です。

このステップは重要です!隔離属性を削除しないと、PKG インストーラーは開かないか、インストールに失敗します。

ステップ 3:PKG をインストール

インストーラーの準備ができたので、Sokuji とその仮想オーディオドライバーをインストールできます。

インストールプロセス

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

インストールされるもの

  • Sokuji.app - /Applications にインストールされます
  • SokujiVirtualAudio.driver - /Library/Audio/Plug-Ins/HAL にインストールされる仮想オーディオドライバー
  • インストーラーは自動的に CoreAudio を再起動してドライバーをロードします
管理者パスワードが必要なのは、インストーラーがシステムレベルのオーディオドライバーをインストールする必要があるためです。仮想オーディオドライバーは高度なオーディオ処理機能を有効にします。

ステップ 4:初回起動

インストール後、App Store 以外からダウンロードされたため、Sokuji の実行許可を与える必要がある場合があります。

Sokuji を初めて開く

  1. アプリケーションフォルダーに移動します
  2. リストで Sokuji を見つけます
  3. Sokuji を右クリック(または Control クリック)します
  4. コンテキストメニューから「開く」を選択します
  5. セキュリティダイアログが表示されたら、「開く」をクリックして確認します

注:ステップ 2 を正しく完了した場合、セキュリティ警告が表示されない可能性があります。

代替方法

macOS が Sokuji をブロックする場合:
  1. システム環境設定 → セキュリティとプライバシー を開きます
  2. 一般タブに移動します
  3. Sokuji がブロックされているというメッセージが表示されるはずです
  4. 「このまま開く」をクリックします
このセキュリティ警告は初回起動時のみ表示されます。その後は、Launchpad またはアプリケーションから通常どおり Sokuji を開くことができます。

ステップ 5:Sokuji を設定

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

初期設定

  1. macOS がプロンプトを表示したらマイクの権限を付与します
  2. 希望のインターフェース言語を選択します
  3. AI プロバイダー(OpenAI、Google Gemini など)を選択します
  4. 選択したプロバイダーの API キーを入力します
  5. 翻訳のソース言語とターゲット言語を選択します
  6. オーディオデバイスを選択します(リストに「Sokuji Virtual Audio」が表示されるはずです)
  7. マイクとスピーカーの設定をテストします
おめでとうございます!Sokuji の準備が整いました。仮想オーディオドライバーがインストールされ、オーディオデバイスリストで利用できます。マイクボタンをクリックしてリアルタイム翻訳を開始してください。

トラブルシューティング

「パッケージが破損しているため開けません」または PKG がインストールできない

PKG ファイルから隔離属性が削除されていない場合に発生します:
  1. ターミナルを開きます(アプリケーション → ユーティリティ → ターミナル)
  2. 実行:sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. プロンプトが表示されたらパスワードを入力します
  4. PKG のインストールを再試行します
これは署名されていない PKG インストーラーで最も一般的なインストール問題です。

「Sokujiは、開発元が未確認のため開けません」

インストール前に xattr コマンドを実行しなかった場合に発生します:
  1. アプリケーションで Sokuji アプリを右クリックします
  2. メニューから「開く」を選択します
  3. 表示されるダイアログで「開く」をクリックします
この操作は一度だけ必要です。より良い方法:隔離属性を削除してからアンインストールして再インストールします。

マイクが動作しない

Sokuji がマイクにアクセスできない場合:
  1. システム環境設定 → セキュリティとプライバシー → プライバシー を開きます
  2. 左側のサイドバーからマイクを選択します
  3. リストで Sokuji がチェックされていることを確認します
  4. リストにない場合は、Sokuji を再起動し、プロンプトが表示されたら権限を付与します

オーディオ出力がない

翻訳された音声が聞こえない場合:
  1. システム環境設定 → サウンド → 出力 を開きます
  2. 希望の出力デバイスを選択します
  3. 出力音量がミュートされていないことを確認します
  4. Sokuji で、正しい出力デバイスが選択されていることを確認します

Intel Mac でアプリがクラッシュする、またはパフォーマンスの問題

お使いの Mac に合った正しいインストーラーをダウンロードしたか確認してください:
  • Apple Silicon (M1/M2/M3/M4):Sokuji-x.x.x-arm64.pkg を使用
  • Intel:Sokuji-x.x.x-x64.pkg を使用
  • チップの種類を確認:Apple メニュー()→「この Mac について」
  • 間違ったインストーラーを使用した場合は、リリースページから正しいバージョンをダウンロードしてください
  • 正しいインストーラーでもクラッシュが続く場合は、コンソール.app でクラッシュログを確認し、GitHub で報告してください

仮想オーディオドライバーが表示されない

オーディオデバイスに「Sokuji Virtual Audio」が表示されない場合:
  1. ドライバーがインストールされているか確認します:ls /Library/Audio/Plug-Ins/HAL/
  2. 存在しない場合は、Sokuji を再インストールする必要がある可能性があります
  3. 存在する場合は、CoreAudio を再起動してみてください:sudo killall coreaudiod
  4. システム環境設定 → サウンド でデバイスが表示されるか確認します

インストールに管理者パスワードが必要

これは正常で必要です:
  • PKG インストーラーはシステムレベルのオーディオドライバーをインストールする必要があります
  • システムオーディオドライバーのインストールには管理者権限が必要です
  • プロンプトが表示されたらパスワードを入力してください - これは安全で予想される動作です
  • 管理者アクセス権がない場合は、システム管理者に連絡してください