Documentazione

Piattaforme supportate

Requisiti

• Windows 10 o 11: un .exe in un unico file, senza installazione.
• Linux x86_64: un'AppImage che include il proprio Python. Richiede glibc 2.35 o successiva (Ubuntu 22.04, Debian 12, Fedora 36, Linux Mint 21 o successive).
• Dal codice sorgente: Python 3.10 o successivo con Tcl/Tk, nessun'altra dipendenza.
• Per guardare: Streamlink e un lettore video, VLC come predefinito.

Su Linux il launcher non ha icona nell'area di notifica, scorciatoia globale, avvio con il sistema, trascinamento, notifiche delle dirette, anteprime degli stream né aggiornamento integrato.

Lingue

Le due app sono disponibili in inglese, francese, spagnolo, tedesco e italiano. Seguono la lingua del sistema; puoi cambiarla in Impostazioni › Generale (Launcher) o Impostazioni › Visualizzazione (Chat).

Streamlink è un programma libero a riga di comando. Recupera il flusso video di uno stream e lo invia al tuo lettore. Così guardi Twitch, Kick o YouTube in VLC o mpv, senza la pagina web intorno: meno memoria, niente pubblicità di Twitch e le scorciatoie del tuo lettore.

Di solito Streamlink si usa in un terminale:

Streamlink Launcher scrive questo comando al posto tuo: riconosce la piattaforma, aggiunge le opzioni giuste e la qualità scelta, poi avvia Streamlink. Streamlink Chat lo usa per il suo pulsante ▶.

Qualità

best sceglie la qualità più alta, worst la più bassa, audio_only solo l'audio (Twitch). Puoi anche chiedere una qualità precisa come 1080p60, o un elenco di riserva: 720p60,720p,best prende la prima disponibile.

E la pubblicità di Twitch?

Dalla versione 7.5.0, Streamlink filtra sempre la pubblicità degli stream di Twitch. La vecchia opzione --twitch-disable-ads non serve più (è deprecata, ma ancora accettata).

Streamlink è disponibile sul suo sito ufficiale, streamlink.github.io/install. Scegli il tuo sistema:

Verificare l'installazione

Se il comando mostra un numero di versione, è tutto pronto. Nel Launcher, Impostazioni › Streamlink mostra anche la versione trovata.

Streamlink installato altrove? Launcher Chat

Le app cercano Streamlink nel PATH e nelle posizioni abituali. Se si trova altrove, indica il percorso di streamlink.exe in Impostazioni › Streamlink › Percorso personalizzato (Launcher) o in Impostazioni › Guarda (Chat).

Dove mettere le app Launcher Chat

Scarica il file dalla pagina delle versioni (Launcher, Chat) e mettilo in una cartella tua, per esempio Documents\Streamlink. Le impostazioni vengono salvate accanto e l'aggiornamento integrato può sostituire il file. Evita C:\Program Files, che è protetta da scrittura.

Su Linux, rendi eseguibile l'AppImage, poi avviala:

Per avere una voce nel menu delle applicazioni, usa uno strumento come Gear Lever o AppImageLauncher.

Il tuo primo stream Launcher

1. Assicurati che Streamlink e un lettore video siano installati.
2. Scegli la piattaforma con il suo pulsante: Twitch, Kick, YouTube, Dailymotion, Steam TV o Link diretto.
3. Scrivi il nome del canale (eslcs) o incolla un link (https://kick.com/…): un link seleziona la piattaforma da solo.
4. Scegli la qualità se serve, poi Invio o Avvia. Il lettore si apre dopo qualche secondo.
5. Per seguire o fermare lo stream, apri il Registro in fondo alla finestra: mostra l'output di Streamlink e un pulsante Interrompi.

Tre modi più rapidi Launcher

• Copiare un link: copia l'indirizzo di uno stream, poi torna al launcher. Ti propone di avviarlo, e il link è già nella barra mini. Si può disattivare in Impostazioni › Streamlink › Rileva i link copiati.
• Trascinare e rilasciare (Windows): trascina sulla finestra l'indirizzo dalla barra del browser, un testo selezionato o un collegamento Internet .url.
• Modalità mini (Windows): Ctrl+Alt+S da qualsiasi applicazione, scrivi, Invio.

La tua prima chat Chat

1. Scegli la piattaforma con il suo pulsante, sotto il campo Aggiungi una chat.
2. Scrivi il nome del canale o incolla un link, poi Invio. Ctrl+T porta il cursore in questo campo.
3. La chat si apre in una nuova scheda, in sola lettura. Per scrivere, collega il tuo account (vedi Scrivere in chat).
4. Nell'intestazione della chat, ▶ apre lo stream con Streamlink e l'icona del link apre il canale nel browser.

Il campo accetta un nome (eslcs), un prefisso (kick:lunaria, steam:nome) o un link: twitch.tv/…, kick.com/…, steam.tv/…, steamcommunity.com/broadcast/watch/…, link «popout» compresi. Le tue schede tornano al prossimo avvio.

Finestra principale Launcher

La scorciatoia globale può essere sostituita con Ctrl+Alt+Spazio, Ctrl+Maiusc+Spazio, Alt+Maiusc+S o Ctrl+Alt+L, in Impostazioni › Finestra e scorciatoia.

Modalità mini Launcher

Schede e scrittura Chat

Clic nella chat Chat

Aggiungere un preferito Launcher

1. Scegli la piattaforma con il suo pulsante (Twitch, Kick…) e scrivi il nome del canale.
2. Fai clic sulla scheda Aggiungi ai preferiti nella schermata principale.

La schermata principale mostra i preferiti della piattaforma selezionata, prima quelli in diretta. Mostra tutto apre l'elenco completo.

Avviare, modificare o rimuovere un preferito Launcher

• Avviare: fai clic sulla sua scheda.
• Altre opzioni: clic destro sulla scheda, poi Avvia, Compila il campo, Apri la chat (Twitch e Kick, in Streamlink Chat) o Rimuovi dai preferiti. Con più preferiti in diretta, Apri le chat dei preferiti in diretta le apre tutte insieme, una scheda per canale; questa scelta è anche nel pannello Preferiti e nel menu dell'icona.
• Nel pannello Preferiti: un clic su una riga compila il campo, ▶ avvia, il cestino rimuove.

Chi è in diretta? Launcher

Con Impostazioni › In diretta › Controlla chi è in diretta, il launcher controlla i tuoi preferiti di Twitch e Kick finché è aperto, ogni 2, 5, 10, 15 o 30 minuti (5 come predefinito). Anteprima delle dirette aggiunge miniatura, titolo e numero di spettatori dei preferiti Twitch in diretta (per Kick: titolo e numero di spettatori, senza immagine), e Notifica di Windows ti avvisa quando un preferito va in diretta: fai clic sulla notifica per guardarlo.

Cronologia Launcher

• Vengono conservati gli ultimi 200 avvii. I più recenti compaiono in Recenti; ▶ li riavvia direttamente.
• Cronologia completa apre il pannello: un clic compila il campo, ▶ riavvia, il cestino elimina una voce, Cancella tutto svuota la cronologia.
• Statistiche, in fondo al pannello, mostra il tempo per canale e le tue ore di punta, negli ultimi 30 giorni o dall'inizio. La durata di uno stream viene annotata quando finisce (almeno un minuto); queste statistiche restano sul tuo computer.
• I suggerimenti del campo di inserimento vengono dai tuoi preferiti, poi dalla cronologia: usa ↓ ↑, poi Invio.

Fare un backup o passare a un altro PC Launcher

Impostazioni › Backup › Esporta… salva impostazioni e preferiti in un unico file. Importa… li ripristina e ti lascia scegliere: Sì aggiunge i preferiti importati ai tuoi, No sostituisce i tuoi preferiti, Annulla non cambia nulla. I percorsi specifici del computer (Streamlink, lettore, script) non sono inclusi, e nemmeno la cronologia.

E nella chat? Chat

Streamlink Chat non ha preferiti: le chat aperte tornano da sole al prossimo avvio. Chiudi una chat con Ctrl+W o con un clic centrale sulla sua scheda. Per aprire sempre le stesse chat in un colpo solo, vedi la ricetta Aprire le tue chat da un collegamento.

Dove sono i file?

Ogni file ha una copia .bak della versione precedente: se un file si danneggia, l'app lo recupera. Nel Launcher, Impostazioni › Informazioni › Apri la cartella dei dati apre la cartella giusta.

Dove vengono conservati i token? Chat

• In chat.json. Su Windows sono cifrati con DPAPI: solo il tuo account Windows, su questo PC, può rileggerli.
• Su Linux sono salvati in chiaro nella tua cartella personale. Non condividere questo file.
• Se copi chat.json su un altro PC, lì i token non potranno essere letti: accedi di nuovo.

Disconnettersi e revocare l'accesso Chat

• Disconnetti, in Impostazioni › Account, elimina i token dal tuo PC.
• Per revocare l'accesso anche dal lato di Twitch, apri Impostazioni › Connessioni su Twitch e scollega la tua applicazione.
• Dal lato di Kick, elimina l'applicazione nelle impostazioni sviluppatore.

Da dove vengono le emote? Chat

Ogni fornitore si può attivare o disattivare in Impostazioni › Emote. Gli elenchi vengono caricati dai loro server all'apertura di una chat.

Formati, animazioni e cache Chat

• Tk, la libreria grafica, mostra solo PNG e GIF: un'emote offerta solo in WebP o AVIF resta come testo.
• Le emote animate si muovono solo nella chat visualizzata, con al massimo 40 fotogrammi ciascuna. Impostazioni › Visualizzazione › Emote animate le blocca tutte.
• Le immagini scaricate vengono conservate in cache/emotes/ per non scaricarle di nuovo. Questa cartella non viene mai svuotata automaticamente: puoi eliminarla a chat chiusa, viene ricostruita quando serve.

Come viene letta ogni piattaforma

Questi canali non ufficiali possono cambiare senza preavviso. Quando succede, lo stato della diretta resta sconosciuto o la chat va in errore finché l'app non viene aggiornata.

Cosa mostra la chat Chat

• Badge (streamer, moderatore, VIP, abbonato…) e colori dei nomi adattati per restare leggibili sul tema.
• Risposte, abbonamenti e altri eventi. I messaggi eliminati e quelli degli utenti bannati appaiono barrati.
• I messaggi che citano il tuo nome o una parola di Impostazioni › Menzioni vengono evidenziati, e la loro scheda lo segnala.

Scegliere il lettore del pulsante ▶ Chat

La chat avvia Streamlink senza alcuna opzione per il lettore, quindi Streamlink usa quello del suo file di configurazione, VLC come predefinito. Per passare a mpv, crea questo file (senza estensione) e aggiungi:

Se mpv non è nel PATH, metti il suo percorso completo dopo player=. Il Launcher usa questo file anche quando Impostazioni › Lettore video è su Predefinito (impostazione di Streamlink).

Guardare con meno ritardo

Streamlink ha una modalità a bassa latenza per Twitch e Kick. Il modo più semplice è attivarla per una sola piattaforma, con un file di configurazione per il suo plugin, accanto al file config:

Funziona con entrambe le app. Il guadagno dipende dallo streamer, che deve aver attivato la bassa latenza; la riproduzione potrebbe andare in buffering un po' più spesso.

Registrare uno stream mentre lo guardi

In un terminale, --record scrive lo stream in un file mentre lo guardi:

{author} diventa il nome del canale e {time:…} la data e l'ora. Apri il file .ts con VLC o mpv.

Launcher Per farlo dal launcher, aggiungi una piattaforma dedicata in platforms.json (il link Modifica platforms.json in fondo alle impostazioni), con un percorso completo verso la tua cartella dei video:

Riavvia il launcher: compare un pulsante Twitch REC. hosts resta vuoto perché i link di Twitch incollati continuino ad andare al normale pulsante Twitch. In JSON, ogni \ di un percorso Windows si scrive \\.

Mai più «qualità non trovata»

Non tutti i canali offrono tutte le qualità. Launcher Nell'elenco delle qualità, scegli Personalizzata… e inserisci un elenco di riserva come 720p60,720p,best: Streamlink prende la prima che esiste e il launcher la ricorda per questa piattaforma. Chat La qualità del pulsante ▶ si sceglie da un elenco fisso; tieni best se guardi canali molto diversi.

Aprire le tue chat da un collegamento Chat

Streamlink Chat accetta le chat come argomenti. Crea un collegamento di Windows (clic destro sul desktop › Nuovo › Collegamento) con una destinazione come:

Se la chat è già aperta, queste chat vengono aggiunte alla finestra esistente. Anche un link di canale funziona come argomento.

Suggerimento: prima rinomina l'eseguibile senza numero di versione, per esempio StreamlinkChat.exe. Un file che porta la sua versione nel nome cambia nome a ogni aggiornamento e il collegamento non lo troverebbe più. Un nome senza versione viene mantenuto.

Avviare il launcher ridotto a icona Launcher

Impostazioni › Finestra e scorciatoia › Avvia con Windows lo avvia nell'area di notifica. Puoi fare lo stesso con un tuo collegamento aggiungendo --tray dopo il percorso dell'eseguibile.

Tenere i tuoi vecchi script .bat Launcher

Se prima avviavi gli stream con degli script, attiva Impostazioni › Avanzate › Mostra gli script .bat e scegli la Cartella degli script. Un pulsante Script elenca i file .bat, .cmd, .ps1, .exe, .py e .lnk di quella cartella. Il campo permette di passare un argomento allo script (solo lettere, cifre, ., _ e -).

Il launcher Launcher

1. Apri Impostazioni › Informazioni: la scheda mostra la tua versione e l'ultima pubblicata su GitHub.
2. Se esiste una versione più recente, fai clic su Aggiorna. Il launcher scarica il nuovo .exe, ne verifica dimensione e impronta SHA-256, lo mette al posto del vecchio e si riavvia.

• Cerca aggiornamenti all'avvio fa il controllo da solo.
• Aggiorna il launcher automaticamente installa anche la nuova versione all'avvio, mai durante uno stream.
• Un file che porta la sua versione nel nome (StreamlinkLauncher-1.4.2.exe) prende il nuovo numero; l'avvio con Windows segue il nuovo nome.

La chat Chat

Stessa idea in Impostazioni › Aggiornamenti: Verifica, poi Aggiorna. La chat si riavvia con le tue chat aperte. Un punto sul pulsante delle impostazioni segnala una nuova versione, e Aggiornamenti automatici (disattivato come predefinito) fa tutto da solo all'avvio.

Aggiornare Streamlink stesso

Il launcher confronta la tua versione di Streamlink con l'ultima pubblicata. Se la tua è più vecchia, la scheda Impostazioni › Streamlink propone Aggiorna: con il programma di installazione di Windows apre la pagina di download, con pip copia il comando pip install -U streamlink. Con winget, Chocolatey, Scoop o la tua distribuzione Linux, usa il loro solito comando di aggiornamento (winget upgrade streamlink, per esempio).

Cosa c'è di nuovo?

I dettagli di ogni versione sono nel registro delle modifiche, in inglese e francese: Launcher, Chat. I download sono nelle pagine delle versioni: Launcher, Chat.

Cosa contatta il launcher Launcher

Cosa contatta la chat Chat

Cosa resta sul tuo PC

• Impostazioni, preferiti, cronologia, chat aperte: nei file descritti in Dove sono i file, da nessun'altra parte.
• Token di accesso (Chat): cifrati con DPAPI su Windows, in chiaro nella tua cartella personale su Linux.
• Appunti (Launcher): letti solo per riconoscere un link di stream; né salvati né inviati.
• Log: launcher.log e chat.log annotano gli errori (due file da 512 KB al massimo ciascuno). Restano sul tuo PC, a meno che tu non li alleghi a una segnalazione.
• Registro di Windows (Launcher): un solo valore, StreamlinkLauncher in HKCU\Software\Microsoft\Windows\CurrentVersion\Run, e solo se Avvia con Windows è attivo.

Il launcher su Windows Launcher

1. Se Avvia con Windows è attivo, disattivalo prima in Impostazioni › Finestra e scorciatoia.
2. Annota dove sono i tuoi dati: Impostazioni › Informazioni › Apri la cartella dei dati. Se vuoi tenere i preferiti, fai un Esporta….
3. Chiudi il launcher: clic destro sulla sua icona accanto all'orologio › Esci.
4. Elimina il .exe, poi la cartella dei dati (config.json, platforms.json, streams/, launcher.log e i file .bak), accanto al .exe o in %APPDATA%\Streamlink Launcher.

Già eliminato senza disattivare l'avvio? Disattiva la voce in Gestione attività › App di avvio, oppure elimina il valore StreamlinkLauncher da HKCU\Software\Microsoft\Windows\CurrentVersion\Run.

La chat su Windows Chat

1. In Impostazioni › Account, fai clic su Disconnetti per ogni account, poi revoca l'accesso dal lato di Twitch o Kick se vuoi (vedi Scrivere in chat).
2. Chiudi la chat.
3. Elimina il .exe, chat.json e il suo .bak, la cartella cache/ e chat.log, accanto al .exe o in %APPDATA%\Streamlink Chat.

Su Linux Launcher Chat

Elimina l'AppImage, poi le cartelle dei dati:

Se hai creato una voce di menu con Gear Lever o AppImageLauncher, rimuovila da quello strumento.

E Streamlink?

Si disinstalla a parte, nello stesso modo in cui l'hai installato: Impostazioni di Windows › App per il programma di installazione, winget uninstall streamlink, pip uninstall streamlink o il gestore di pacchetti della tua distribuzione. Il suo file di configurazione si trova in %APPDATA%\streamlink o ~/.config/streamlink.

Prima di aprire una segnalazione

• Aggiorna l'app: solo l'ultima versione riceve correzioni.
• Cerca tra le segnalazioni esistenti (Launcher, Chat): il problema potrebbe essere già noto.
• Rileggi la Risoluzione dei problemi.

Cosa includere

• L'app e la sua versione (Impostazioni › Informazioni o Impostazioni › Aggiornamenti).
• Il tuo sistema (Windows 11, Ubuntu 24.04…) e il tipo di installazione: .exe, AppImage o codice sorgente.
• La versione di Streamlink: streamlink --version.
• Cosa hai fatto, cosa ti aspettavi e cosa è successo. Per una chat, la piattaforma e il canale.
• Il log: launcher.log o chat.log (e .log.1 se esiste), nella cartella dei dati. Per uno stream che non parte, copia anche il testo del pannello del registro.

Leggi il log prima di inviarlo. Può contenere nomi di canali o percorsi del tuo PC; togli tutto ciò che non vuoi rendere pubblico.

Poi apri una segnalazione: Launcher o Chat.

Una vulnerabilità di sicurezza?

Non aprire una segnalazione pubblica. Usa il modulo privato di GitHub (Launcher, Chat) con la versione, i passaggi per riprodurla e l'impatto. Riceverai una risposta entro una settimana circa.

Contribuire

Segnalazioni di bug, traduzioni e pull request sono benvenute.

1. Per qualsiasi cosa più grande di una piccola correzione, apri prima una segnalazione per parlarne.
2. Ti basta Python 3.10 o successivo, senza dipendenze di terze parti. Tkinter è necessario per l'interfaccia.
3. Esegui i controlli prima della pull request:

• Aggiungi una riga sotto Unreleased in CHANGELOG.md, in inglese e in francese.
• Le versioni vengono pubblicate dal manutentore.

Tradurre le app

I testi si trovano in lang/*.json, un file per lingua (fr, en, es, de, it). Ogni lingua deve avere esattamente le stesse chiavi: un test lo verifica. Per una nuova lingua, copia en.json, traduci i valori senza toccare le chiavi né le {variabili} e tieni i testi brevi, soprattutto nel launcher.