ChatGPT Web Voiceを、Google Meetまたは任意のZoom Web AppへGPT-Liveという別参加者として接続するmacOS向けの実験的ベータ版です。OpenAI APIは使わず、Meetron専用の仮想音声デバイスで会議音声とChatGPT音声を双方向に橋渡しします。既定はGoogle Meetで、Zoom対応はベータ機能です。
このプロジェクトは非公式であり、OpenAI、Apple、Google、Zoomの提供・承認を受けた製品ではありません。ChatGPT、Google Meet、Zoomの画面変更により、自動化が動かなくなる可能性があります。
このリポジトリは、構成を理解して自力またはローカル操作対応のAIアシスタントで導入・診断できる利用者向けの、source-firstなCommunity版です。Git、Node.js、Chromeのデベロッパーモード、macOSの署名・権限を扱います。一般消費者向けの公証済みデスクトップアプリ、自動アップデート、Chrome Web Store版、Windows版、組織管理、SLAは現在のOSSリリースには含まれません。
対応範囲とIssueを開く前の確認はSUPPORT.md、変更点はCHANGELOG.mdを参照してください。
Google MeetやZoomで資料、広告レポート、グラフなどが画面共有されているとき、会議上のMeetronパネルからGPTに画面を送るを押すと、その時点でGPT参加者に見えている画面をChatGPTへ送れます。ChatGPTは音声だけでは分からない数値や図表も会議の背景情報として使えるため、資料について意見を求めたり、注目すべき変化や確認事項を会話の中で尋ねたりできます。
送信は自動ではなく、ボタンを押したときにだけ行われます。先に資料を読ませておきたい場合はGPT参加者をミュートしてから送ることもでき、Google MeetとZoomのどちらでも同じように使えます。
送られる画像には、共有資料だけでなく、その時点で会議画面に見えている参加者名、チャット、通知などが含まれる場合があります。送信前に内容を確認し、必要に応じて会議参加者の同意を得てください。画像はMeetronのファイルとしてMacへ保存されませんが、送信後はChatGPTの会話内容として扱われます。
初回導入は、ローカルのファイルとターミナルを操作できるAIコーディング支援へ任せる方法を推奨します。ターミナルのコマンドを自分で入力する必要はありません。
- AIアシスタントへ、下の依頼文をコピーして渡す
- AIがこのリポジトリをcloneしたら、Finderでclone先を開く
Meetron Setup.commandをダブルクリックする- 画面に従ってMeetron Audioをインストールする
- Macを再起動し、同じ
Meetron Setup.commandをもう一度開く - 案内されたChrome拡張の読み込みとGoogle・ChatGPTへのログインだけを本人が行う
https://github.com/bb8ad8/meetron のMeetronをこのMacへcloneし、READMEの「AIアシスタントによるセットアップ」に従って、利用できる状態までセットアップしてください。安全に自動化できる確認とコマンドは進め、管理者認証、再起動、Chrome拡張の読み込み、Google・ChatGPTへのログインが必要になったら私へ案内してください。パスワードや認証コードをAIチャットへ入力するよう求めないでください。
詳しいAI向け依頼文と役割分担はAIアシスタントによるセットアップにあります。
すでにMeeting Copilot／Meetronを利用している場合は、GitHubから最新ソースをcloneするか、Code > Download ZIPで取得・展開し、その新しいフォルダ内のMeetron Update.commandをダブルクリックします。現在利用中の旧フォルダを自動検出して同じ場所を更新するため、Chrome拡張フォルダの選び直しやChatGPT Project URLの再入力は不要です。Meetron Audio利用者には署名・公証済みPKGの更新とMac再起動を案内し、BlackHole 2ch / 16ch利用者は既存の音声構成を変更せず、Chrome再起動だけを案内します。
AirDropやブラウザから取得したソースでは、未署名の.commandがmacOSに止められる場合があります。これは署名・公証済みのMeetron Audio PKGとは別の、ソース配布スクリプトに対するGatekeeperの確認です。.commandが開けない場合に従うか、ターミナルから同等のスクリプトを実行してください。
- macOS 13以降（実機はmacOS 26 / Apple Siliconで確認）
- Google Chrome公式ビルド
- Node.js 22または24 LTS
- ChatGPT Web Voiceを利用できるアカウント
- Google Meetへ参加できるGoogleアカウント
Intel MacとmacOS 13〜15では未検証のベストエフォート対応です。音声PKGはApple Silicon / IntelのUniversal Binaryとしてビルドします。Chrome Web Store版はなく、GitHubから取得した拡張をデベロッパーモードで読み込みます。
GitHubからcloneした後は、Finderでリポジトリを開き、Meetron Setup.commandをダブルクリックします。ターミナルを利用する場合は./scripts/setup-meetron.shを実行できます。セットアップは現在の状態を判定し、次に必要な操作だけを表示します。
- Meetron Audioが未導入: ダウンロード済みの正規PKGを探し、Appleの署名・公証を確認してFinderとインストーラを開く
- PKGがまだない: GitHub ReleasesとFinderのダウンロードフォルダを開く
- PKG導入直後: Macの再起動を案内する
- 再起動済み: Node.js依存関係、Native Messaging Host、Chrome拡張の設定へ進む
PKGは開発元がYuki Inabaであることを自動確認します。パスワードやTouch IDはMeetronやAIチャットへ入力せず、macOSのインストーラ画面へ直接入力してください。途中で画面を閉じても、同じMeetron Setup.commandをもう一度開けば続きから判定します。
既存ユーザーは、GitHubからcloneまたはCode > Download ZIPで取得した新しいソースフォルダでMeetron Update.commandをダブルクリックします。更新プログラムはNative Messaging Hostの登録から現在Chromeが利用しているMeetronフォルダを特定し、その同じパスへ新しいファイルをコピーします。
.meeting-copilot.env、.meeting-copilot-runtime、Git履歴、専用Chromeプロファイル、Google／ChatGPTログイン状態を保持- 更新前のソースを
~/Library/Application Support/Meetron/Backups/へ退避 - Gitで管理しているファイルに未コミット変更がある場合は、上書きせず停止
- Node.js依存関係とNative Messaging Hostを更新
- Meetron Audioが古い場合だけ、新しいPKGの署名、公証、チェックサムを検証してインストーラを開く
- BlackHoleまたは旧内製ドライバが正常に動いている場合は、その音声バックエンドを維持してPKGを強制しない
Meetron Audioを更新した場合はMacを再起動します。BlackHoleを維持した場合は、Google Chromeを終了して再度開くだけで拡張0.10.1が読み込まれます。更新元として使った新しい配布フォルダは、更新完了後に削除して構いません。
Meetron Setup.commandとMeetron Update.commandはOSSソースに含まれるシェルスクリプトであり、Developer ID署名・Apple公証されたアプリではありません。AirDrop、ブラウザダウンロード、ZIP展開によって隔離属性が付くと、macOSが「開発元が未確認」と表示する場合があります。
入手元と内容を確認した上で実行する場合は、一度開こうとした後に「システム設定」>「プライバシーとセキュリティ」>「セキュリティ」から「このまま開く」を選びます。Appleの説明は開発元が不明なMacアプリを開くを参照してください。Gatekeeper全体を無効化したり、ダウンロードフォルダ全体の隔離属性を削除したりしないでください。
ソースを確認できる利用者は、リポジトリ直下で次を実行する方法もあります。
./scripts/setup-meetron.sh
./scripts/update-meetron.sh --dry-run実際の更新は、新しい配布フォルダから./scripts/update-meetron.shを引数なしで実行します。--dry-runは既存インストールの検出と安全確認だけを行います。
- Google Meetへの統合参加を自動化
- Zoom Web Appは任意のベータ機能として、URL自動判定、専用Chrome起動、ブラウザ参加、表示名、Meetron音声経路、カメラオフ、参加前ミュート、参加要求、待機／参加状態、マイク、退出を自動化
- 会議URL、初回マイク案内、表示名、音声デバイス、参加前ミュートを自動設定
- ChatGPT Projectでの新規チャット作成とVoice開始を自動設定
- 拡張の
開始と統合起動では参加リクエストまで自動化。低レベル起動では--join指定時のみ自動化 - 発話抑制はProject instructionsと会議側ミュートで行う
- 普段使うChromeのGoogle Meet／Zoom上に表示する小型UIから、GPT参加者の接続確認、マイク、Voice、セッション終了、環境診断を遠隔操作
- Google Meet／Zoomの小型UIから、専用Chromeに表示中の会議画面をChatGPTへ画像コンテキストとして明示的に送信
旧公開版から更新するユーザーに限り、BlackHole 2ch / 16chを移行期間中の互換バックエンドとして自動検出します。新規セットアップではBlackHoleを導入しません。Meetronは既存のBlackHoleを削除・変更しないため、ほかのアプリで引き続き利用できます。
会議参加者の音声
-> 専用ChromeのGPT参加者（Meet / Zoom）
-> 会議speaker: Meetron: Meeting to AI
-> 専用ChromeのChatGPT Voice input: Meetron: Meeting to AI
ChatGPT Voice output
-> ChatGPT VoiceタブだけをMeetron: AI to Meetingへ出力
-> GPT参加者の会議mic: Meetron: AI to Meeting
-> Google Meet / Zoom Web App
-> 利用者が参加している会議
-> 現在の物理出力（ヘッドホン／スピーカー）
Meeting to AIとAI to Meetingを別々のステレオデバイスにすることで、ChatGPTの発話が自分の入力へ戻るループを防ぎます。入力と出力は専用Chrome内の対象タブごとに選択し、macOSのシステム既定入力・出力は変更しません。デバイスの識別には表示名ではなく安定したCore Audio UIDを使います。
Meetronは、音声ドライバ、macOSの音声設定、2つのChrome環境、GoogleとChatGPTのログインを扱うPoCです。非エンジニアがREADMEのコマンドを順番に実行するのではなく、Codexなどローカル操作に対応したAIアシスタントへ導入を任せ、本人確認が必要な場面だけ利用者が操作することを想定しています。
ローカル操作に対応したAIアシスタントを開き、次の依頼文を渡してください。すでにリポジトリを取得している場合は、そのフォルダをAIに開かせてから依頼します。
https://github.com/bb8ad8/meetron のMeetronを、このMacで利用できる状態までセットアップしてください。
README.mdを最初から最後まで読み、最初に環境診断と短い作業計画を示してください。これは非エンジニア向けのセットアップです。質問だけで止まらず、安全に実行できる確認、ダウンロード、コマンド、設定、ローカルテストはあなたが進めてください。
次の順序でセットアップしてください。
1. macOS 13以降、Apple SiliconまたはIntel、Google Chrome、Node.js 22または24 LTSを確認する
2. リポジトリ直下の「Meetron Setup.command」を開く。必要なら同等の./scripts/setup-meetron.shを実行する
3. Meetron Audioが未導入なら、セットアップが見つけたPKGの署名、公証、チェックサムを確認する。PKGがなければ、セットアップが開くGitHub Releasesから最新のMeetronAudio-*.pkgとSHA-256ファイルを取得して、もう一度セットアップを実行する
4. PKGの開発元が「Yuki Inaba」であることを説明して私にインストール操作を依頼し、インストール後にMacを再起動する
5. 普段使うChromeとMeetron専用Chromeで、extensionフォルダを「パッケージ化されていない拡張機能」として読み込む場所を正確に示す
6. 専用ChromeでGoogleとChatGPTへログインし、ChatGPTに「Meetron」Projectを作成して、このREADMEのProject instructionsを設定するよう案内する
7. ./scripts/check-env.shとローカルテストを実行し、最後に機密情報を含まないGoogle Meetで双方向音声を確認する
音声にはMeetron Audioを使用してください。BlackHole、Homebrew、SwitchAudioSourceを新規導入しないでください。ソースからの音声ドライバービルドは、配布PKGが利用できない理由が確認できた場合だけ提案してください。
次の操作が必要になったら勝手に進めず、理由と操作内容を短く説明して私に依頼してください。
- macOS管理者パスワードまたはTouch ID
- macOSの再起動
- Chromeでのデベロッパーモード有効化と拡張機能の読み込み
- GoogleまたはChatGPTへのログインと2段階認証
- ChatGPT Projectの作成とInstructions設定
- テスト会議への参加、参加許可、音声確認
パスワードや認証コードをAIチャットへ入力するよう求めないでください。各工程の後に状態を再確認し、失敗した場合はログを調べてから次へ進んでください。
すでに公開版を利用している場合は、リポジトリを開いて次の依頼文を渡してください。
このMacで利用中のMeeting Copilotを、既存設定とログイン状態を保持したままMeetronへ更新してください。
README.mdを最初から最後まで読み、現在のGit状態、macOS、チップ、Node.js、Chrome、音声デバイス、Meetron Audio PKGの有無を先に診断してください。作業前に短い更新計画を示し、安全に自動化できる確認、コマンド、設定、ローカルテストはあなたが進めてください。
次の条件を守って更新してください。
- 私のローカル変更があれば上書きせず、内容を説明してから安全な対処を相談する
- .meeting-copilot.env、.meeting-copilot-runtime、専用Chromeプロファイル、拡張機能ID、Native Messaging Host IDを削除・改名しない
- GoogleとChatGPTのログイン状態をできる限り保持する
- Git更新はgit pull --ff-onlyを基本にし、リセット、強制チェックアウト、履歴の書き換えをしない。配布ZIPを使う場合はMeetron Update.commandまたは./scripts/update-meetron.shを使う
- BlackHole 2ch / 16chが正常な既存バックエンドなら削除・更新・設定変更せず、そのまま維持する
- Meetron Audioが導入済みで古い場合、または互換音声バックエンドが存在しない場合だけ、GitHub ReleasesのMeetronAudio-*.pkgについてSHA-256、Appleの署名、公証結果を確認する
- PKGが必要な場合だけ、表示上の開発元が「Yuki Inaba」であることを説明し、管理者認証と再起動は私に依頼する
- 再起動が必要な更新後は「Meetron Setup.command」または./scripts/setup-meetron.shを実行する
- ChromeのMeetron Controlsを再読み込みし、必要な場合だけ同じextensionフォルダを読み込み直す
- ./scripts/check-env.shとローカルテストの後、機密情報を含まないGoogle Meetで双方向音声を確認する
既存のBlackHoleはMeetron以外で使っている可能性があるため、アンインストール、更新、設定変更をしないでください。新しい音声経路にはMeetron Audioを優先し、移行中に問題が起きた場合だけ従来経路を一時的なフォールバックとして使用してください。
次の操作が必要になったら勝手に進めず、理由と操作内容を短く説明して私に依頼してください。
- macOS管理者パスワードまたはTouch ID
- macOSの再起動
- Chromeでのデベロッパーモード有効化、拡張機能の読み込み・再読み込み
- GoogleまたはChatGPTへの再ログインと2段階認証
- テスト会議への参加、参加許可、音声確認
パスワードや認証コードをAIチャットへ入力するよう求めないでください。各工程の後に状態を再確認し、失敗した場合はログを調べてから次へ進んでください。
| 工程 | AIが行うこと | 利用者が行うこと |
|---|---|---|
| 取得・診断 | リポジトリの取得場所を特定または相談して取得し、macOS、Chrome、Node.js、音声デバイスを診断 | 保存場所と、AIへ許可する操作範囲を確認 |
| 依存ソフト | PKGの署名とチェックサムを検証し、Node.jsパッケージやローカル連携を設定 | 管理者パスワードやTouch IDはmacOS画面へ直接入力 |
| 再起動 | 再起動前の作業を完了し、再開後に状態を再診断 | Macを再起動し、同じAIへ完了を伝える |
| Chrome拡張 | Native Messaging Hostを登録し、選択する正確なextensionパスと画面を提示 |
普段使うChromeと専用Chromeでデベロッパーモードを有効化し、拡張を手動で読み込む |
| アカウント | 必要なGoogle、ChatGPT、Project画面を開き、完了後の状態を確認 | パスワードと2段階認証を各サービス画面へ直接入力し、Project Instructionsを確認 |
| 動作確認 | ローカルテスト、接続診断、ログ調査を実行 | テスト会議への参加・許可、参加者への通知、別端末での音声確認を実施 |
パスワードや認証コードをAIへ共有する必要はありません。管理者パスワードの入力待ちになった場合は、利用者がターミナルまたはmacOSの確認画面へ直接入力し、処理が終わったことだけをAIへ伝えます。
- AIが環境診断とインストール内容の事前確認を行う
- 利用者がライセンスを確認し、必要な管理者認証を行う
- 専用音声ドライバ導入後、利用者がmacOSを再起動する
- 同じAIとの会話を開き、
再起動しました。続きから確認してと伝える - AIの案内に沿って、利用者がChrome拡張、Google・ChatGPTログインを設定する
- AIが診断とローカルテストを実行する
- 利用者がテスト会議で最終確認する
拡張を読み込んだ後は、不足している設定をポップアップのステップ形式UIでも確認できます。
ChatGPT WebでMeetron Projectを作り、次の内容をProject instructionsへ設定します。
あなたは「GPT-Live」という名前で会議に参加する助言者です。
会議中の発言を聞き、現在の議題、合意事項、未決事項、前提、懸念、次の行動を内部で追跡してください。
通常は完全に沈黙してください。相づち、挨拶、確認、要約、笑い、フィラー、聞き返しを含め、自発的な音声を一切出さないでください。
「ChatGPT、どう思う？」「GPT、どう思う？」「GPT-Live、どう思う？」「GPT、応答して」「GPT-Live、応答して」のように、名前を呼ばれ、同じ発言内で意見または回答を明示的に求められた場合だけ発話してください。誰に向けた発言か曖昧な場合は沈黙してください。
発話するときは30秒以内で、現在の論点、見落とされていそうなリスクまたは前提、次に取るべき具体的な提案の順に簡潔に答えてください。不確かなことを断定せず、回答後は再び完全に沈黙してください。
Project instructionsだけでは発話抑制を保証できません。会議側のGPT参加者マイクを外側の安全装置として使用し、意図しない発話時は直ちにミュートしてください。
以下は、AIアシスタントが内部で実行する主なコマンドと、手動で問題を切り分ける場合の参考手順です。通常の初回導入では、利用者がすべてを自分で実行する必要はありません。
一般利用では、最初にリポジトリ直下のMeetron Setup.commandをダブルクリックします。未導入なら、セットアップがGitHub ReleasesとFinderを開き、ダウンロード済みのMeetronAudio-*.pkgを検証してインストーラを開きます。管理者認証後にMacを再起動し、同じファイルをもう一度開いてください。PKG利用時はXcode、Swift、Homebrewは不要です。
AIアシスタントまたはターミナルから同じ処理を行う場合は次を実行します。
./scripts/setup-meetron.shこのセットアップはNode.js、Chrome、Meetron Audioを確認し、JavaScript依存関係とNative Messaging Hostを準備して、Chrome拡張を読み込む画面を開きます。Chromeのデベロッパーモード、拡張フォルダの選択、Google・ChatGPTへのログインは利用者が行います。
ソースから音声部分をビルドする開発者は、Xcode Command Line Toolsを用意して次を実行します。
./scripts/check-env.sh
./scripts/install-audio-deps.sh --dry-run
./scripts/install-audio-deps.shドライバの導入では管理者認証が必要です。導入後にmacOSからログアウトするか再起動し、./scripts/check-env.shで2つのデバイスを確認します。ローカル開発だけでCore Audioを即時再起動する場合は--restart-audioを使えます。
Google Meet／Zoom上へ常駐する開発版Chrome拡張とNative Messaging Hostを設定します。
npm ci
./scripts/install-control-ui.sh普段使うChromeでデベロッパーモードを有効にし、extensionディレクトリを「パッケージ化されていない拡張機能」として読み込みます。初期セットアップから、MeetとChatGPTで共用する専用Chromeを開き、同じ拡張をそちらにも一度読み込みます。Chrome公式ビルドでは開発版拡張をコマンドだけで読み込めないため、このディレクトリ選択だけは手動です。
普段使うChromeで拡張を開くと、音声デバイス、ChatGPT Project、専用Chromeを順に確認する初期セットアップが表示されます。完了後はGoogle Meet／Zoomを選ぶか、会議URLをそのまま貼り付けます。URLからサービスを自動判定し、Google Meetは参加とマイク解除まで、Zoomはブラウザ参加、音声設定、参加要求まで自動で実行します。通常Chromeの会議ページ上に出るパネルは専用ChromeのGPT参加者だけを操作し、ユーザー本人の会議マイクには触れません。
普段使うChromeと専用Chromeが同じGoogleアカウントの場合、Meetronは「その他の参加方法」から「このデバイスでも参加」を選びます。独立した音声経路が必要なため、コンパニオン モードは使用しません。
Google Meet／Zoomでは、GPT参加者が参加しChatGPT Voiceが起動すると、パネルのGPTに画面を送るが有効になります。押すと、専用Chromeの現在の会議タブに表示されている範囲をJPEGで取得し、会議サービス名を含む説明文と一緒に現在のChatGPT会話へ送ります。画像はメモリ上で直接添付し、Meetronのローカルファイルとして保存しません。送信前に、共有画面に含まれる機密情報、参加者名、通知、チャットなどもChatGPTへ送ってよいか確認してください。失敗時はパネルにエラーコードと処理段階を表示し、画像、会議URL、プロンプトを含まない診断情報を.meeting-copilot-runtime/visual-context.logへ記録します。
画面送信時にGPT参加者がミュートかどうかは必須条件にしていません。先に情報を渡す場合はパネルのマイク操作で手動ミュートできます。ChatGPTには必要になるまで発言を控えるよう伝えますが、即座に反応しないことは保証されません。意図しない発話時はパネルからミュートしてください。
拡張ポップアップでZoomを選ぶか、https://...zoom.us/j/...形式の招待URLを貼り付けて開始します。Zoom URLを貼り付けた場合は自動でZoomへ切り替わります。
開始すると、専用Chromeで次を自動実行します。
ブラウザから参加へ進む- 表示名を
GPT-Liveにする - マイクを
Meetron: AI to Meeting、スピーカーをMeetron: Meeting to AIへ固定する - カメラをオフ、マイクをミュートにする
- 音声経路とミュートを検証してから参加を要求する
待機室が有効な会議では、ホストの承認だけ手動です。カメラが接続されていない旨の通知は、カメラを使わないため参加の妨げになりません。自動検出が失敗した場合だけ、ポップアップのスタートガイドに従って同じ設定を確認してください。Zoomは日本語と英語が混在する場合があるため、Meetronは表示文言だけでなく、安定した要素ID、操作状態、音声トラックを組み合わせて判定します。
Zoomホストがブラウザ参加を無効にしている会議では利用できません。招待URLのpwdは自動参加にだけ利用し、ログ、実行状態、Chrome拡張ストレージ、長時間起動するChromeのプロセス引数には保存しません。URLに正しいpwdが含まれていれば、利用者によるパスコード入力は不要です。Zoomの公式手順はブラウザから会議へ参加する方法を参照してください。
./scripts/open-gpt-participant.sh "https://meet.google.com/xxx-yyyy-zzz"Google Meetのマイク権限、初回案内、表示名、専用音声デバイス、参加前ミュートを自動設定する場合:
npm ci
./scripts/open-gpt-participant.sh --auto-prepare --restart-profile \
"https://meet.google.com/xxx-yyyy-zzz"自動設定は専用Chromeプロファイルだけを再起動し、127.0.0.1に限定したChrome DevTools接続を一時的に使います。この専用Chromeではメディア権限ダイアログを自動承認します。通常のChromeプロファイルには接続しません。--joinを追加すると、Meetの検証準備を待ってから参加リクエストも送信します。
ChatGPTのMeetron Projectで毎回新しいチャットを作成し、Voiceを開始する場合:
./scripts/open-chatgpt-live.sh --restart-profile初回だけ、Meetと共用する専用ChromeでChatGPTへログインし、同じコマンドを再実行します。Project URLはローカル専用の.meeting-copilot.envへ保存し、リポジトリ配布には含めません。専用Chrome内のChatGPT Voice入力をMeetron: Meeting to AI、Voice出力をMeetron: AI to Meetingへ固定します。macOSのシステム既定入力・出力は変更しません。
ChatGPT Voiceを開始し、会議への参加リクエストまでまとめて実行する場合:
./scripts/start-meetron.sh \
"https://meet.google.com/xxx-yyyy-zzz"統合起動では、同じ専用Chromeの別タブでChatGPT Voiceと会議ページを開き、入室後に会議マイクも自動解除します。Voice再起動はChatGPTタブだけを作り直すため、会議参加状態を維持します。低レベルのopen-gpt-participant.sh --joinだけを実行した場合はミュートのままです。Google Meetで--joinを使う場合は専用ChromeでGoogleへ一度ログインしてください。
参加ボタン表示後の固定待機は既定で2秒です。必要な場合はMEETING_COPILOT_JOIN_DELAYで調整できます。MeetのUIからマイクボタンを検出できない場合は、標準ショートカットへ自動的にフォールバックします。カメラ状態を安全に判定できないUIでは参加ボタンを自動で押さず、参加後のマイク解除も実行しません。専用ChromeとChatGPT Voiceを開いたまま通常Chromeのパネルへ「手動参加待ち」と表示するので、専用Chromeでカメラをオフにして手動参加してください。
会議中にGPT参加者のマイクをローカルから制御する場合、互換用の旧ファイル名を維持している次のコマンドを使います。現在アクティブなGoogle Meet／Zoom参加者を自動判定して操作します。
./scripts/set-meet-mic.sh mute
./scripts/set-meet-mic.sh unmute
./scripts/set-meet-mic.sh toggle常駐パネルのセッション終了は、GPT参加者のミュート、ChatGPT Voice停止、会議退出、専用会議タブの終了をまとめて実行します。旧版が変更したmacOS音声設定の復旧データが残っている場合は、次のコマンドで一度だけ復元できます。
./scripts/restore-audio.sh2026年7月以降のChatGPTデスクトップアプリにもVoiceがありますが、クラウドProjectを外部から選択してVoiceを開始する公開APIはありません。このPoCでは、自動化可能で今回の実機テストが通ったChatGPT Web Voiceを利用します。
ChatGPT側にはREADMEのProject instructionsを設定し、最初は機密情報を含まないテスト会議と別端末で双方向音声を確認してください。
旧公開版を利用中の場合も、ローカル設定や専用Chromeを削除せず、そのまま更新できます。新しい配布フォルダ内のMeetron Update.commandを開くか、そのフォルダのターミナルから./scripts/update-meetron.shを実行してください。
- GitHubから最新ソースをcloneするか、
Code>Download ZIPで取得して任意の場所へ展開する Meetron Update.commandを開く。Gatekeeperに止められた場合は.commandが開けない場合に従うか、ターミナルから./scripts/update-meetron.shを実行する- Meetron Audioの更新を案内された場合だけ、macOSインストーラを完了してMacを再起動する
- BlackHoleを継続する場合は、案内に従ってGoogle Chromeを終了して再度開く
- 機密情報を含まないテスト会議で確認する
.meeting-copilot.env、.meeting-copilot-runtime、~/Library/Application Support/MeetingCopilot、MEETING_COPILOT_*環境変数、Native Messaging Host IDは既存ユーザーとの互換性のため当面維持します。これらは内部識別子であり、画面上の製品名はMeetronです。
BlackHoleを導入済みでも削除する必要はありません。更新プログラムはBlackHole 2ch / 16chが現在の正常なバックエンドであることを確認すると、Meetron Audio PKGを要求せずそのまま維持します。MeetronはBlackHoleを自動削除・更新せず、macOSの音声設定も変更しません。新規ユーザーがBlackHoleを導入する必要はありません。
専用Chromeを終了してから、Native Messaging Host登録を削除します。
./scripts/uninstall.sh専用Chromeプロファイル、ローカル設定、実行ログも削除する場合:
./scripts/uninstall.sh --remove-data --yesシステムへ導入した2つの仮想音声デバイス、音声制御CLI、PKGレシートも削除する場合は、--remove-audio-driverを追加します。管理者認証後、ログアウトまたは再起動が必要です。
保存していたmacOS音声設定を復元できない場合、アンインストールは中止され、復旧データは削除されません。元の音声デバイスを再接続してから再実行してください。最後に、普段使うChromeのchrome://extensionsからMeetron Controlsを削除します。--remove-dataを使わない場合は、専用Chromeからも同じ拡張を削除してください。
JavaScript、シェル、Chrome拡張、自動化の標準テストは次で実行します。このテストにはSwiftやXcode Command Line Toolsは不要です。
npm test音声ドライバのソースを変更した開発者は、Xcode Command Line ToolsがあるMacでCリングバッファを追加検証します。
npm run test:native配布PKGの生成とUniversal Binary、macOS 13 deployment target、チェックサムの検証はリリース作業で実行します。通常のpackage:audioは開発用PKGをdist/development/へ生成し、公証済みの公開成果物とは分離します。
npm run package:audio
npm run test:package公開用PKGはDeveloper IDとApple公証の設定後、npm run package:audio:releaseでdist/release/へ生成します。この処理は公証設定がなければ停止し、既存の公証済みPKGを上書きしません。
Community配布ZIPは、クリーンなリリースコミットから次のように生成します。音声PKGを指定すると、署名・公証済みPKGとチェックサムも同梱します。
npm run package:community -- \
--audio-pkg dist/release/MeetronAudio-AUDIO_VERSION.pkg完全な公開手順と別Macでの検証項目はRELEASING.mdにあります。
PKGをインストールして利用するだけのユーザーは、これらの開発者テストを実行する必要はありません。./scripts/setup-meetron.sh --check-onlyと./scripts/check-env.shを使ってください。
不具合報告では、SUPPORT.mdを確認し、macOSとChromeのバージョン、再現手順、.meeting-copilot-runtime/meeting-launch.logからアカウント情報や会議URLを除いた内容をIssueへ添えてください。画面送信の失敗は、画像や会議URLを記録しない.meeting-copilot-runtime/visual-context.logも確認してください。修正提案はCONTRIBUTING.mdに従ってください。セキュリティ上の問題は公開Issueへ書かず、SECURITY.mdの連絡方法を利用してください。
MeetronはGNU General Public License v3.0で提供します。仮想音声ドライバはAppleのAudio Server Plug-in公式サンプルを土台にしており、由来と上流ライセンスは第三者通知へ記録しています。Playwrightなど外部依存のライセンスは各パッケージに従います。
本ソフトウェアは実験的な自動化ツールであり、会議への参加、録音、要約、判断の正確性や継続動作を保証しません。本番会議へ導入する前に、機密情報を含まない会議で確認してください。
会議音声をChatGPTへ送る前に、所属組織の規定と参加者への通知・同意要件を確認してください。
データの扱いはPRIVACY.md、脆弱性の報告はSECURITY.md、開発参加はCONTRIBUTING.mdを参照してください。