Estensione browser

MediaGo include una leggera estensione browser Manifest V3 che rileva URL video / audio scaricabili su qualsiasi sito e li invia a MediaGo con un clic.

Cosa fa

• Rileva stream HLS / m3u8 e file multimediali diretti .mp4 / .flv / .mov in ogni pagina visitata
• Riconosce pagine video Bilibili e URL YouTube video / short / live / embed
• Mostra il numero di risorse rilevate nel badge dell'icona della toolbar
• Importa una singola sorgente o tutte le sorgenti in MediaGo con un clic (desktop o self-hosted)

Installazione

L'estensione non è ancora su Chrome Web Store, quindi deve essere caricata come "estensione non pacchettizzata". L'installer di MediaGo Desktop la include già: non devi scaricarla separatamente.

1. Apri MediaGo Desktop
2. Vai in Impostazioni → Altre impostazioni → Directory estensione browser e clicca il pulsante per aprire la cartella dell'estensione
3. In Chrome / Edge, visita chrome://extensions/
4. Attiva Modalità sviluppatore in alto a destra
5. Clicca Carica estensione non pacchettizzata e seleziona la cartella aperta al punto 2
6. Dovresti vedere l'icona dell'estensione nella toolbar: fissala per accedervi più facilmente

Modalità di invio

Clicca l'icona ingranaggio nel popup per aprire la pagina opzioni, poi scegli una modalità:

Modalità	Quando usarla	Richiede
Desktop · Protocollo schema	MediaGo Desktop installato localmente; il browser può passare link protocollo	Nessuna configurazione; la prima chiamata mostra "Aprire MediaGo?" — spunta "Consenti sempre" per l'invio silenzioso successivo
Desktop · HTTP locale (default)	MediaGo Desktop installato e in esecuzione	Nessuna configurazione; l'estensione si connette a 127.0.0.1:39719
Docker / Self-hosted · HTTP	Connessione a un server MediaGo remoto, ad esempio Docker	URL server richiesto; API Key se il server è avviato con --enable-auth

L'estensione non effettua mai fallback silenziosi. Una volta scelta una modalità, qualsiasi errore viene mostrato così com'è: cambia modalità manualmente nella pagina opzioni se necessario.

Comportamento di importazione

Due toggle nella pagina opzioni sotto Comportamento importazione:

• Avvia download subito — On: l'attività viene messa in coda e avviata. Off: viene solo aggiunta alla lista, in attesa dell'avvio manuale. Vale per Schema e HTTP.
• Importazione silenziosa (modalità Schema) — On: il deeplink include silent=1 e MediaGo crea subito l'attività. Off: MediaGo apre il modulo download precompilato con nome / tipo / cartella rilevati per la revisione. Vale solo in modalità Schema; HTTP è sempre silenzioso.

Lingua interfaccia

L'estensione supporta cinese, inglese e italiano. Per impostazione predefinita segue la lingua UI del browser. Puoi forzare la scelta nella pagina opzioni sotto Lingua interfaccia: Segui sistema / 中文 / English / Italiano.

Risoluzione problemi

Il pulsante "Directory estensione browser" non fa nulla

• Sviluppo: esegui prima pnpm -F @mediago/extension build per generare la dist
• Produzione: reinstalla MediaGo: la cartella resources/extension/ dovrebbe esistere nella directory di installazione dell'app

Il test connessione Desktop · HTTP fallisce

• Verifica che MediaGo Desktop sia in esecuzione
• Verifica che la porta 39719 non sia occupata da un altro processo (netstat -ano | findstr 39719 su Windows)
• Se esegui anche MediaGo in modalità web/server locale, nota che Go Core standalone usa 9900, non 39719

La modalità Schema chiede conferma ogni volta

Al primo passaggio Chrome mostra "Aprire MediaGo-community?": spunta Consenti sempre. Le chiamate successive saranno silenziose.

La modalità Schema fallisce con l'importazione batch

Schema invia una sola attività per chiamata: è una limitazione fondamentale dei protocolli di hand-off. Passa alla modalità HTTP (Desktop o Docker) per importazioni batch.