titleId Title ID | string | si | — 1234 | L'ID numerico del titolo sul sito sorgente. Lo trovi nell'URL della pagina del titolo (es. /watch/1234 → titleId="1234"). Supporta {{espressioni}} dinamiche. |
episodeId Episode ID | string | no | — 99 (vuoto per i film) | L'ID dell'episodio per le serie TV. Lascia vuoto per i film. Lo trovi nell'URL della pagina episode (es. /watch/1234?e=99 → episodeId="99"). |
baseUrl URL base del sito sorgente | string | si | — https://streamingcommunityz.example | L'URL https:// del sito (senza slash finale). Cambia ogni settimana — lega il valore al rotator (un nodo HTTP che probesta il dominio attivo) per resilienza. Solo https:// e` accettato — http:// viene rifiutato dal SSRF guard. |
localePrefix Prefisso locale (es. /it) | string | no | /it /it | Pattern /xx — alcune mirror site usano /en, /es, /fr. Deve combaciare con la lingua del sito sorgente. |
embedHostBase URL host dell'embed (VixCloud-like) | string | no | https://vixcloud.co https://vixcloud.co | L'host che ospita l'embed player (HLS). Default vixcloud.co. Usato solo quando la route-page emette uno scws_id parziale invece di un embedUrl assoluto. |
timeoutMs Timeout per ciascuna fetch (ms) | number | no | 15000 | Timeout applicato a ciascuna delle 3 fetch della pipeline (route, embed, opzionale verify). Range 1000–60000. |
maxRetries Max retry pipeline su token scaduto | number | no | 1 | Quante volte rieseguire l'intera pipeline se il verify post-extract rileva un token scaduto (401/403/410). Range 0–3. Ignorato se verifyStreamLive=off. |
pipelineTimeoutMs Timeout totale pipeline (ms) | number | no | 30000 | Wall-clock per tutta la pipeline (somma stadi + retry). Range 3000–120000. |
followRedirects Segui redirect HTTP | boolean | no | true | Default on — i siti sorgente spesso fanno 301/302 verso il dominio canonico. Disabilita solo per debug. |
userAgent User-Agent | string | no | Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36 | User-Agent usato sia per le fetch sia copiato nelle headers di playback (le condivisione con il player garantisce che il token resti valido). NON impersonare bot conosciuti — i siti sorgente li 403. |
acceptLanguage Accept-Language | string | no | it-IT,it;q=0.9,en;q=0.7 | Influenza la lingua del dub/sub servito dal sito sorgente. |
preferFhd Preferisci ladder FHD (1080p) | boolean | no | true | Quando il sito espone canPlayFHD, lo onoriamo. Questo flag conta solo come default quando il sito non emette il flag esplicitamente. |
verifyStreamLive Verifica streamUrl con HEAD probe | boolean | no | false | Esegue una HEAD post-extract per validare che il token sia ancora valido. Costa un round-trip extra. Default off — la maggior parte dei caller (VLC response-dispatcher) consuma streamUrl immediatamente, il rischio di token scaduto e` minimo. |
includePipelineLog Includi log per-stadio nell'output | boolean | no | true | Aggiunge l'array pipelineSteps con timing, attempt#, e snippet evidence per ciascuno stadio. Imprescindibile per il debug, costa ~3–8 KB di JSON extra. |