Documentation

Plateformes prises en charge

Configuration requise

• Windows 10 ou 11 : un .exe d'un seul fichier, sans installation.
• Linux x86_64 : une AppImage qui embarque son propre Python. Il faut la glibc 2.35 ou plus récente (Ubuntu 22.04, Debian 12, Fedora 36, Linux Mint 21 ou plus récents).
• Depuis les sources : Python 3.10 ou plus récent avec Tcl/Tk, aucune autre dépendance.
• Pour regarder : Streamlink et un lecteur vidéo, VLC par défaut.

Sous Linux, le lanceur n'a pas l'icône de notification, le raccourci global, le démarrage automatique, le glisser-déposer, les notifications de live, les aperçus des streams ni la mise à jour intégrée.

Langues

Les deux applis existent en français, anglais, espagnol, allemand et italien. Elles suivent la langue du système ; tu peux la changer dans Paramètres › Général (Launcher) ou Paramètres › Affichage (Chat).

Streamlink est un programme libre en ligne de commande. Il récupère le flux vidéo d'un stream et l'envoie à ton lecteur. Tu regardes donc Twitch, Kick ou YouTube dans VLC ou mpv, sans la page web autour : moins de mémoire, pas de publicité Twitch, et les raccourcis de ton lecteur.

Streamlink s'utilise normalement dans un terminal :

Streamlink Launcher écrit cette commande pour toi : il reconnaît la plateforme, ajoute les bonnes options et la qualité choisie, puis lance Streamlink. Streamlink Chat s'en sert pour son bouton ▶.

Les qualités

best prend la meilleure qualité, worst la plus basse, audio_only le son seul (Twitch). Tu peux aussi demander une qualité précise comme 1080p60, ou une liste de secours : 720p60,720p,best prend la première disponible.

Et les publicités Twitch ?

Depuis la version 7.5.0, Streamlink retire toujours les publicités des streams Twitch. L'ancienne option --twitch-disable-ads est devenue inutile (elle est dépréciée, mais encore acceptée).

Streamlink se télécharge depuis son site officiel, streamlink.github.io/install. Choisis ton système :

Vérifier l'installation

Si la commande affiche un numéro de version, c'est bon. Dans Launcher, Paramètres › Streamlink affiche aussi la version trouvée.

Streamlink installé ailleurs ? Launcher Chat

Les applis cherchent Streamlink dans le PATH et aux emplacements habituels. S'il est ailleurs, indique le chemin de streamlink.exe dans Paramètres › Streamlink › Chemin personnalisé (Launcher) ou Paramètres › Regarder (Chat).

Où ranger les applis Launcher Chat

Télécharge le fichier depuis la page des releases (Launcher, Chat) et place-le dans un dossier à toi, par exemple Documents\Streamlink. Les réglages se rangent à côté, et la mise à jour intégrée peut remplacer le fichier. Évite C:\Program Files, qui est protégé en écriture.

Sous Linux, rends l'AppImage exécutable puis lance-la :

Pour une entrée dans le menu des applications, utilise un outil comme Gear Lever ou AppImageLauncher.

Ton premier stream Launcher

1. Vérifie que Streamlink et un lecteur vidéo sont installés.
2. Choisis la plateforme avec sa pastille : Twitch, Kick, YouTube, Dailymotion, Steam TV ou Lien direct.
3. Tape le nom de la chaîne (eslcs) ou colle un lien (https://kick.com/…) : un lien choisit la plateforme tout seul.
4. Choisis la qualité si besoin, puis Entrée ou Lancer. Le lecteur s'ouvre après quelques secondes.
5. Pour suivre ou arrêter le stream, ouvre le Journal en bas de la fenêtre : il montre la sortie de Streamlink et un bouton Arrêter.

Trois façons plus rapides Launcher

• Copier un lien : copie l'adresse d'un stream, puis reviens sur le lanceur. Il propose de le lancer, et le lien est déjà dans la barre mini. Désactivable dans Paramètres › Streamlink › Détecter les liens copiés.
• Glisser-déposer (Windows) : fais glisser l'adresse depuis la barre du navigateur, un texte sélectionné ou un raccourci Internet .url sur la fenêtre.
• Mode mini (Windows) : Ctrl+Alt+S depuis n'importe quelle application, tape, Entrée.

Ton premier chat Chat

1. Choisis la plateforme avec sa pastille, sous le champ Ajouter un chat.
2. Tape le nom de la chaîne ou colle un lien, puis Entrée. Ctrl+T place le curseur dans ce champ.
3. Le chat s'ouvre dans un nouvel onglet, en lecture seule. Pour écrire, connecte ton compte (voir Écrire dans le chat).
4. Dans l'en-tête du chat, ▶ ouvre le stream avec Streamlink et l'icône de lien ouvre la chaîne dans ton navigateur.

Le champ accepte un nom (eslcs), un préfixe (kick:lunaria, steam:nom) ou un lien : twitch.tv/…, kick.com/…, steam.tv/…, steamcommunity.com/broadcast/watch/…, liens « popout » compris. Tes onglets reviennent au démarrage suivant.

Fenêtre principale Launcher

Le raccourci global peut être remplacé par Ctrl+Alt+Espace, Ctrl+Maj+Espace, Alt+Maj+S ou Ctrl+Alt+L, dans Paramètres › Fenêtre et raccourci.

Mode mini Launcher

Onglets et saisie Chat

Clics dans le chat Chat

Ajouter un favori Launcher

1. Choisis la plateforme avec sa pastille (Twitch, Kick…) et tape le nom de la chaîne.
2. Clique sur la carte Ajouter un favori sur l'écran principal.

L'écran principal affiche les favoris de la plateforme choisie, ceux en direct d'abord. Tout voir ouvre la liste complète.

Lancer, modifier ou retirer un favori Launcher

• Lancer : clique sur sa carte.
• Plus d'options : clic droit sur la carte, puis Lancer, Remplir le champ, Ouvrir le chat (Twitch et Kick, dans Streamlink Chat) ou Retirer des favoris. Avec plusieurs favoris en direct, Ouvrir les chats des favoris en direct les ouvre tous d'un coup, un onglet par chaîne ; ce choix est aussi dans le panneau Favoris et le menu de l'icône.
• Dans le panneau Favoris : un clic sur une ligne remplit le champ, ▶ lance, la corbeille retire.

Qui est en direct ? Launcher

Avec Paramètres › En direct › Vérifier qui est en direct, le lanceur vérifie tes favoris Twitch et Kick tant qu'il est ouvert, toutes les 2, 5, 10, 15 ou 30 minutes (5 par défaut). Aperçu des lives ajoute l'image, le titre et le nombre de spectateurs des favoris Twitch en direct (pour Kick : le titre et le nombre de spectateurs, sans image), et Notification Windows te prévient quand un favori commence un live : clique sur la notification pour regarder.

L'historique Launcher

• Les 200 derniers lancements sont gardés. Les plus récents s'affichent sous Récents ; ▶ relance directement.
• Historique complet ouvre le panneau : un clic remplit le champ, ▶ relance, la corbeille efface une entrée, Tout effacer vide l'historique.
• Statistiques, en bas du panneau, montre le temps passé par chaîne et tes heures de pointe, sur les 30 derniers jours ou depuis le début. La durée d'un stream est notée quand il se termine (une minute au moins) ; ces statistiques restent sur ton ordinateur.
• Les suggestions du champ de saisie viennent de tes favoris puis de ton historique : utilise ↓ ↑ puis Entrée.

Sauvegarder ou copier sur un autre PC Launcher

Paramètres › Sauvegarde › Exporter… enregistre tes réglages et tes favoris dans un seul fichier. Importer… les restaure et te laisse choisir : Oui ajoute les favoris importés aux tiens, Non remplace tes favoris, Annuler ne change rien. Les chemins propres à l'ordinateur (Streamlink, lecteur, scripts) ne sont pas inclus, et l'historique non plus.

Et dans le chat ? Chat

Streamlink Chat n'a pas de favoris : les chats ouverts reviennent tout seuls au démarrage suivant. Ferme un chat avec Ctrl+W ou un clic du milieu sur son onglet. Pour ouvrir toujours les mêmes chats d'un coup, vois la recette Ouvrir ses chats depuis un raccourci.

Où sont les fichiers ?

Chaque fichier a une copie .bak de sa version précédente : si un fichier est endommagé, l'appli la récupère. Launcher Paramètres › À propos › Ouvrir le dossier des données ouvre le bon dossier.

Où sont gardés les jetons ? Chat

• Dans chat.json. Sous Windows, ils sont chiffrés avec DPAPI : seul ton compte Windows, sur ce PC, peut les relire.
• Sous Linux, ils sont enregistrés en clair dans ton dossier personnel. Ne partage pas ce fichier.
• Si tu copies chat.json sur un autre PC, les jetons y sont illisibles : reconnecte-toi.

Se déconnecter et retirer l'accès Chat

• Se déconnecter, dans Paramètres › Comptes, efface les jetons de ton PC.
• Pour retirer aussi l'accès côté Twitch, ouvre Paramètres › Connexions sur Twitch et déconnecte ton application.
• Côté Kick, supprime l'application dans les paramètres développeur.

D'où viennent les emotes ? Chat

Chaque fournisseur s'active ou se coupe dans Paramètres › Emotes. Les listes sont chargées depuis leurs serveurs à l'ouverture d'un chat.

Formats, animations et cache Chat

• Tk, la bibliothèque graphique, n'affiche que le PNG et le GIF : une emote proposée seulement en WebP ou AVIF reste écrite en texte.
• Les emotes animées ne bougent que dans le chat affiché, avec 40 images au plus chacune. Paramètres › Affichage › Emotes animées les fige toutes.
• Les images téléchargées sont gardées dans cache/emotes/ pour ne pas les retélécharger. Ce dossier n'est pas vidé automatiquement : tu peux le supprimer quand le chat est fermé, il se reconstruit au besoin.

Comment chaque plateforme est lue

Ces accès non officiels peuvent changer sans prévenir. Quand c'est le cas, le statut en direct reste inconnu ou le chat passe en erreur jusqu'à une mise à jour de l'appli.

Ce que le chat affiche Chat

• Badges (diffuseur, modérateur, VIP, abonné…), couleurs des pseudos ajustées pour rester lisibles sur le thème.
• Réponses, abonnements et autres événements. Les messages supprimés et ceux des personnes exclues sont barrés.
• Les messages qui citent ton pseudo ou un mot de Paramètres › Mentions sont surlignés, et leur onglet le signale.

Choisir le lecteur du bouton ▶ Chat

Le chat lance Streamlink sans option de lecteur : Streamlink utilise donc celui de son fichier de configuration, VLC par défaut. Pour passer à mpv, crée ce fichier (sans extension) et ajoute :

Si mpv n'est pas dans le PATH, mets son chemin complet après player=. Launcher utilise aussi ce fichier quand Paramètres › Lecteur vidéo est sur Par défaut (réglage de Streamlink).

Regarder avec moins de retard

Streamlink a un mode faible latence pour Twitch et Kick. Le plus simple est de l'activer pour une seule plateforme, avec un fichier de configuration propre à son plugin, à côté du fichier config :

Ça marche pour les deux applis. Le gain dépend du diffuseur, qui doit avoir activé la faible latence ; la lecture peut un peu plus souvent se mettre en mémoire tampon.

Enregistrer un stream en le regardant

Dans un terminal, --record écrit le flux dans un fichier pendant que tu regardes :

{author} devient le nom de la chaîne et {time:…} la date et l'heure. Ouvre le .ts avec VLC ou mpv.

Launcher Pour le faire depuis le lanceur, ajoute une plateforme dédiée dans platforms.json (lien Modifier platforms.json en bas des paramètres), avec un chemin complet vers ton dossier de vidéos :

Redémarre le lanceur : une pastille Twitch REC apparaît. hosts reste vide pour que les liens Twitch collés continuent d'aller vers la pastille Twitch normale. Dans le JSON, chaque \ d'un chemin Windows s'écrit \\.

Ne jamais tomber sur « qualité introuvable »

Toutes les chaînes ne proposent pas toutes les qualités. Launcher Dans la liste des qualités, choisis Personnalisée… et saisis une liste de secours comme 720p60,720p,best : Streamlink prend la première qui existe, et le lanceur la retient pour cette plateforme. Chat La qualité du bouton ▶ se choisit dans une liste fixe ; garde best si tu regardes des chaînes très différentes.

Ouvrir ses chats depuis un raccourci Chat

Streamlink Chat accepte des chats en arguments. Crée un raccourci Windows (clic droit sur le bureau › Nouveau › Raccourci) avec une cible comme :

Si le chat est déjà ouvert, ces chats s'ajoutent à la fenêtre existante. Un lien de chaîne marche aussi comme argument.

Astuce : renomme d'abord l'exécutable sans numéro de version, par exemple StreamlinkChat.exe. Un fichier nommé d'après sa version change de nom à chaque mise à jour, et le raccourci ne le trouverait plus. Un nom sans version est gardé.

Démarrer le lanceur réduit Launcher

Paramètres › Fenêtre et raccourci › Lancer au démarrage de Windows le démarre dans la zone de notification. Tu peux faire pareil avec ton propre raccourci, en ajoutant --tray après le chemin de l'exécutable.

Garder ses anciens scripts .bat Launcher

Si tu lançais tes streams avec des scripts, active Paramètres › Avancé › Afficher les scripts .bat et choisis le Dossier des scripts. Une pastille Scripts liste les fichiers .bat, .cmd, .ps1, .exe, .py et .lnk de ce dossier. Le champ te permet de passer un argument au script (lettres, chiffres, ., _ et - uniquement).

Le lanceur Launcher

1. Ouvre Paramètres › À propos : la carte indique ta version et la dernière publiée sur GitHub.
2. Si une version plus récente existe, clique sur Mettre à jour. Le lanceur télécharge le nouvel .exe, vérifie sa taille et son empreinte SHA-256, le met à la place de l'ancien et redémarre.

• Vérifier les mises à jour au démarrage fait la vérification tout seul.
• Mises à jour automatiques du lanceur installe aussi la nouvelle version au démarrage, jamais pendant un stream.
• Un fichier nommé d'après sa version (StreamlinkLauncher-1.4.2.exe) prend le nouveau numéro ; le démarrage avec Windows suit le nouveau nom.

Le chat Chat

Même principe dans Paramètres › Mises à jour : Vérifier, puis Mettre à jour. Le chat redémarre avec tes chats ouverts. Une pastille sur le bouton des paramètres signale une nouvelle version, et Mises à jour automatiques (désactivé par défaut) fait tout seul au démarrage.

Mettre à jour Streamlink lui-même

Le lanceur compare ta version de Streamlink à la dernière publiée. Si elle est plus ancienne, la carte de Paramètres › Streamlink propose Mettre à jour : avec l'installateur Windows, elle ouvre la page de téléchargement ; avec pip, elle copie la commande pip install -U streamlink. Avec winget, Chocolatey, Scoop ou ta distribution Linux, utilise leur commande de mise à jour habituelle (winget upgrade streamlink, par exemple).

Quoi de neuf ?

Le détail de chaque version est dans le journal des modifications, en anglais et en français : Launcher, Chat. Les fichiers à télécharger sont sur les pages des releases : Launcher, Chat.

Ce que le lanceur contacte Launcher

Ce que le chat contacte Chat

Ce qui reste sur ton PC

• Réglages, favoris, historique, chats ouverts : dans les fichiers décrits dans Où sont les fichiers, nulle part ailleurs.
• Jetons de connexion (Chat) : chiffrés avec DPAPI sous Windows, en clair dans ton dossier personnel sous Linux.
• Presse-papiers (Launcher) : lu seulement pour y repérer un lien de stream ; ni enregistré, ni envoyé.
• Journaux : launcher.log et chat.log notent les erreurs (deux fichiers de 512 Ko au plus chacun). Ils restent sur ton PC tant que tu ne les joins pas à un ticket.
• Registre Windows (Launcher) : une seule valeur, StreamlinkLauncher dans HKCU\Software\Microsoft\Windows\CurrentVersion\Run, et seulement si Lancer au démarrage de Windows est activé.

Le lanceur sous Windows Launcher

1. Si Lancer au démarrage de Windows est activé, désactive-le d'abord dans Paramètres › Fenêtre et raccourci.
2. Note où sont tes données : Paramètres › À propos › Ouvrir le dossier des données. Si tu veux garder tes favoris, fais un Exporter….
3. Quitte le lanceur : clic droit sur son icône près de l'horloge › Quitter.
4. Supprime l'.exe, puis le dossier des données (config.json, platforms.json, streams/, launcher.log et les .bak), à côté de l'.exe ou dans %APPDATA%\Streamlink Launcher.

Déjà supprimé sans désactiver le démarrage ? Désactive l'entrée dans le Gestionnaire des tâches › Applications de démarrage, ou supprime la valeur StreamlinkLauncher de HKCU\Software\Microsoft\Windows\CurrentVersion\Run.

Le chat sous Windows Chat

1. Dans Paramètres › Comptes, clique sur Se déconnecter pour chaque compte, puis retire l'accès côté Twitch ou Kick si tu veux (voir Écrire dans le chat).
2. Ferme le chat.
3. Supprime l'.exe, chat.json et sa .bak, le dossier cache/ et chat.log, à côté de l'.exe ou dans %APPDATA%\Streamlink Chat.

Sous Linux Launcher Chat

Supprime l'AppImage, puis les dossiers de données :

Si tu as créé une entrée de menu avec Gear Lever ou AppImageLauncher, retire-la depuis cet outil.

Et Streamlink ?

Il se désinstalle à part, comme tu l'as installé : Paramètres Windows › Applications pour l'installateur, winget uninstall streamlink, pip uninstall streamlink ou le gestionnaire de paquets de ta distribution. Son fichier de configuration est dans %APPDATA%\streamlink ou ~/.config/streamlink.

Avant d'ouvrir un ticket

• Mets l'appli à jour : seule la dernière version reçoit des correctifs.
• Cherche dans les tickets existants (Launcher, Chat) : le problème est peut-être déjà connu.
• Parcours le dépannage.

Ce qu'il faut indiquer

• L'appli et sa version (Paramètres › À propos ou Paramètres › Mises à jour).
• Ton système (Windows 11, Ubuntu 24.04…) et le type d'installation : .exe, AppImage ou sources.
• La version de Streamlink : streamlink --version.
• Ce que tu as fait, ce que tu attendais et ce qui s'est passé. Pour un chat, la plateforme et la chaîne.
• Le journal : launcher.log ou chat.log (et .log.1 s'il existe), dans le dossier des données. Pour un stream qui ne démarre pas, copie aussi le texte du tiroir du journal.

Relis le journal avant de l'envoyer. Il peut contenir des noms de chaînes ou des chemins de ton PC ; retire ce que tu ne veux pas rendre public.

Puis ouvre un ticket : Launcher ou Chat.

Une faille de sécurité ?

N'ouvre pas de ticket public. Utilise le formulaire privé de GitHub (Launcher, Chat) avec la version, les étapes pour reproduire et l'impact. Réponse sous environ une semaine.

Contribuer

Signalements, traductions et pull requests sont les bienvenus.

1. Pour tout ce qui dépasse un petit correctif, ouvre d'abord un ticket pour en discuter.
2. Il suffit de Python 3.10 ou plus récent, sans aucune dépendance tierce. Tkinter sert pour l'interface.
3. Lance les vérifications avant la pull request :

• Ajoute une ligne sous Unreleased dans CHANGELOG.md, en anglais et en français.
• Les versions sont publiées par le mainteneur.

Traduire les applis

Les textes sont dans lang/*.json, un fichier par langue (fr, en, es, de, it). Toutes les langues doivent avoir exactement les mêmes clés : un test le vérifie. Pour une nouvelle langue, copie en.json, traduis les valeurs sans toucher aux clés ni aux {variables}, et garde des textes courts, surtout dans le lanceur.