--- layout: doc outline: deep --- # ブラウザ拡張機能 MediaGo には軽量な Manifest V3 のブラウザ拡張機能が同梱されており、任意のサイトを閲覧中にダウンロード可能な動画・音声 URL を自動で検出し、ワンクリックで MediaGo に送信できます。 ## できること - HLS / m3u8 ストリームおよび `.mp4` / `.flv` / `.mov` などの直接メディアファイルをすべてのページで検出 - Bilibili 動画ページと YouTube 動画・Shorts・ライブ・埋め込み URL を認識 - ツールバーアイコンのバッジに検出件数を表示 - 検出したリソースを 1 件ずつまたは一括で MediaGo（Desktop または自建サーバー）にインポート ## インストール Chrome Web Store には未公開のため、「パッケージ化されていない拡張機能を読み込む」方式でインストールします。MediaGo Desktop のインストーラーには拡張機能が同梱されているため、別途ダウンロードする必要はありません。 1. MediaGo Desktop アプリを起動します 2. **設定 → その他の設定 → ブラウザ拡張ディレクトリ** のボタンをクリックして、拡張機能フォルダを開きます 3. Chrome / Edge のアドレスバーで `chrome://extensions/` を開きます 4. 右上の **デベロッパーモード** を有効にします 5. **パッケージ化されていない拡張機能を読み込む** をクリックし、手順 2 で開いたフォルダを選択します 6. ツールバーにアイコンが表示されれば成功です。ピン留めしておくと便利です ## 呼び出しモード ポップアップ右上の歯車アイコンから設定ページを開き、以下のいずれかを選択します。 | モード | 利用シーン | 要件 | | ----------------------------------- | ------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- | | **Desktop · Schema プロトコル** | ローカルに MediaGo Desktop がインストールされている | 設定不要。初回は「Open MediaGo?」ダイアログが表示されるので「常に許可」をチェックすれば以降は静かに通ります | | **Desktop · HTTP ローカル**（既定） | ローカルに MediaGo Desktop がインストールされ、起動している | 設定不要。拡張機能は固定で `127.0.0.1:39719` に接続します | | **Docker / 自建サーバー · HTTP** | リモートの自建 MediaGo サーバー（Docker デプロイなど）に接続 | サーバー URL を入力。`--enable-auth` を有効にしている場合は API Key も | > **自動フォールバックはしません。** モードを選んだ後に失敗した場合はそのままエラーとなります。別モードを使うには設定ページで手動切り替えしてください。 ## インポート動作 設定ページの **インポート動作** セクションに 2 つのトグルがあります。 - **すぐにダウンロードを開始** — ON：タスクをキューに入れてすぐに開始。OFF：一覧に追加するだけで、手動で開始するまで待機。Schema / HTTP どちらのモードでも有効。 - **静かにインポート（Schema モードのみ）** — ON：deeplink に `silent=1` を付けて送信し、MediaGo が即座にタスクを作成。OFF：MediaGo が検出結果をプリフィルしたダウンロードフォームを開くので、名前・種類・保存先を確認してから送信できます。Schema モードでのみ有効で、HTTP モードは常に静かに実行されます。 ## インターフェース言語 拡張機能は日本語表示はサポートしておらず、中国語・英語・イタリア語に対応します。既定ではブラウザの UI 言語に追随します。設定ページの **インターフェース言語** から強制切替も可能です（システムに従う / 中文 / English / Italiano）。 ## よくある質問 ### 「ブラウザ拡張ディレクトリ」ボタンが効かない - **開発時**：先に `pnpm -F @mediago/extension build` で dist を生成してください - **本番時**：MediaGo を再インストールして、インストール先に `resources/extension/` が存在することを確認してください ### Desktop · HTTP の接続テストが失敗する - MediaGo Desktop が起動していることを確認 - ポート `39719` が他プロセスに占有されていないか確認（Windows なら `netstat -ano | findstr 39719`） - ローカルで Web/server モードの Go Core も走らせている場合、そちらは `9900` を使います。39719 とは別物です ### Schema モードで毎回ダイアログが出る 初回の「Open MediaGo-community?」ダイアログで **常に許可** にチェックを入れれば、以降は Chrome が静かに Desktop に転送します。 ### Schema モードで一括インポートに失敗する Schema は 1 回の呼び出しで 1 件しか送れません（ブラウザ側のプロトコル呼び出しの制約）。一括インポートには HTTP モード（Desktop または Docker）を使ってください。