wehub-resource-sync
71 lines
5.5 KiB
Markdown
71 lines
5.5 KiB
Markdown
---
|
||
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）を使ってください。
|