ブラウザ拡張機能
MediaGo には軽量な Manifest V3 のブラウザ拡張機能が同梱されており、任意のサイトを閲覧中にダウンロード可能な動画・音声 URL を自動で検出し、ワンクリックで MediaGo に送信できます。
できること
- HLS / m3u8 ストリームおよび
.mp4/.flv/.movなどの直接メディアファイルをすべてのページで検出 - Bilibili 動画ページと YouTube 動画・Shorts・ライブ・埋め込み URL を認識
- ツールバーアイコンのバッジに検出件数を表示
- 検出したリソースを 1 件ずつまたは一括で MediaGo（Desktop または自建サーバー）にインポート
インストール
Chrome Web Store には未公開のため、「パッケージ化されていない拡張機能を読み込む」方式でインストールします。MediaGo Desktop のインストーラーには拡張機能が同梱されているため、別途ダウンロードする必要はありません。
- MediaGo Desktop アプリを起動します
- 設定 → その他の設定 → ブラウザ拡張ディレクトリ のボタンをクリックして、拡張機能フォルダを開きます
- Chrome / Edge のアドレスバーで
chrome://extensions/を開きます - 右上の デベロッパーモード を有効にします
- パッケージ化されていない拡張機能を読み込む をクリックし、手順 2 で開いたフォルダを選択します
- ツールバーにアイコンが表示されれば成功です。ピン留めしておくと便利です
呼び出しモード
ポップアップ右上の歯車アイコンから設定ページを開き、以下のいずれかを選択します。
| モード | 利用シーン | 要件 |
|---|---|---|
| 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）。
よくある質問
「ブラウザ拡張ディレクトリ」ボタンが効かない
- 開発時：先に
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）を使ってください。