Jitsi Meet n'envoie pas automatiquement une réunion sur YouTube : pour une installation Jitsi auto-hébergée, la solution par défaut est Jibri, qui capture la conférence et la diffuse sur YouTube à l'aide de la clé de flux. Si vous avez seulement besoin d'un événement ponctuel, un encodeur de bureau comme OBS peut capturer la fenêtre des participants Jitsi et l'envoyer sur YouTube. Le choix de la solution dépend de la personne qui gérera l'encodeur, de vos besoins en superpositions et en contrôle précis, et de votre capacité à utiliser le service Jibri.
Ce guide décrit les deux options, en commençant par la configuration Jibri auto-hébergée. Il s'adresse aux administrateurs d'un déploiement Jitsi Meet auto-hébergé. Un service Jitsi hébergé peut ne pas proposer de diffusion en direct ; son opérateur détermine la disponibilité de Jibri. YouTube exige actuellement une chaîne vérifiée sans restriction de diffusion en direct au cours des 90 jours précédents. La première activation peut prendre du temps ; assurez-vous donc de vérifier l'éligibilité de votre chaîne avant le jour de l'événement.
Quel format de diffusion convient le mieux à votre événement ?
| Itinéraire | Meilleure adaptation | Compromis principal |
|---|
| Jitsi avec Jibri | Un flux de travail de réunion auto-hébergé et reproductible, où un modérateur lance la diffusion depuis l'interface Jitsi. | Nécessite une configuration Jibri côté serveur ainsi que des ressources suffisantes en termes de processeur, de mémoire et de réseau. La maintenance incombe à l'administrateur Jitsi. |
| Jitsi et OBS sur un ordinateur de présentation | Un événement ponctuel, des mises en page personnalisées, des titres, des superpositions, des scènes locales ou un contrôle accru sur l'encodeur et le protocole d'ingestion. | Nécessite un ordinateur et un opérateur dédiés. La réunion doit rester visible et audible pour le système de capture, et la connexion de transfert de l'ordinateur devient essentielle. |
| Enregistrez, puis téléchargez | Des conférences qui ne nécessitent pas de public en temps réel ni de chat en direct. | Ne crée pas d'événement en direct, mais vous donne le temps de modifier et de vérifier l'enregistrement final avant publication. |
Pour un déploiement géré et auto-hébergé nécessitant un modérateur pour lancer une diffusion de conférence, utilisez Jibri. Privilégiez OBS lorsque le contrôle de la production ou une configuration RTMPS explicite prime sur un flux de travail simplifié. YouTube recommande RTMPS pour l'ingestion chiffrée ; le flux de travail intégré de Jibri et les options de sortie disponibles peuvent varier selon la version, vérifiez donc le protocole de transport pris en charge par votre version installée. Si vous ne pouvez pas vérifier la prise en charge de RTMPS dans votre configuration Jibri, utilisez un encodeur exposant l'URL et le protocole d'ingestion YouTube.
Que fait Jibri, et quel est son coût en ressources ?
Jibri est le composant de diffusion et d'enregistrement de Jitsi. Il ouvre une session de navigateur pour la réunion, capture l'audio et la vidéo rendus, puis encode le résultat pour un service de streaming. Il ne s'exécute pas au sein du rôle de routage multimédia de Jitsi Videobridge. Le projet Jibri précise qu'il est conçu pour fonctionner sur une machine ou une machine virtuelle distincte, sans qu'aucune autre application n'utilise ses périphériques d'affichage ou audio. Une instance de Jibri ne prend en charge qu'un seul enregistrement à la fois. De ce fait, il est plus adapté aux événements planifiés et gérés qu'à une diffusion occasionnelle sur un petit serveur déjà fortement sollicité.
OBS évite d'ajouter Jibri à la pile serveur Jitsi, mais déplace la capture et l'encodage sur l'ordinateur du présentateur. Cette solution peut s'avérer moins coûteuse si vous disposez déjà d'un poste de travail dédié à l'événementiel, mais elle crée une dépendance opérationnelle locale : l'opérateur doit veiller au bon fonctionnement de la fenêtre de réunion, du routage audio, de l'encodeur et de la connexion réseau. Un serveur Jibri centralise ces responsabilités, moyennant la configuration et la maintenance du serveur.
Configurez Jibri pour un déploiement Docker auto-hébergé
Le manuel Docker de Jitsi est régulièrement mis à jour. Utilisez les fichiers Compose et l'exemple d'environnement correspondant à votre version installée ; ne copiez pas les paramètres d'une branche non pertinente ou d'un ancien tutoriel dans un déploiement en production. Les étapes ci-dessous supposent que vous disposez déjà d'une installation Docker Compose Jitsi Meet fonctionnelle et d'un accès administrateur à son hôte.
1. Vérifiez les prérequis de YouTube et de déploiement
Dans YouTube Studio, vérifiez que la chaîne est autorisée à diffuser en direct, puis créez ou programmez un flux d'encodage. Les pages d'aide actuelles de YouTube indiquent qu'une chaîne vérifiée sans restriction de diffusion en direct au cours des 90 derniers jours peut diffuser. Dans les paramètres du flux, trouvez l'URL du serveur et la clé de flux. Considérez la clé de flux comme un mot de passe : toute personne la possédant peut diffuser sur ce flux.
Vérifiez que l'URL de votre réunion Jitsi est accessible publiquement via HTTPS et que l'organisateur et Jibri peuvent la résoudre et accéder aux services nécessaires. Prévoyez une réunion test avant l'événement public. Si vous utilisez un fournisseur Jitsi géré, demandez à son administrateur si la diffusion en direct Jibri est activée ; vous ne pouvez pas l'activer en modifiant les paramètres de votre navigateur.
2. Activez le service Jibri dans Docker Compose
Dans le répertoire contenant vos fichiers Jitsi Compose existants, vérifiez .envque l'option d'enregistrement/diffusion Jibri est bien activée. La documentation Docker actuelle ENABLE_RECORDING=1indique que cette option permet l'enregistrement et la diffusion en direct. Pour un déploiement standard, ajoutez le fichier Jibri Compose à la même commande et incluez les éventuelles surcharges Compose supplémentaires nécessaires à votre installation.
docker compose -f docker-compose.yml -f jibri.yml up -d
N'exécutez pas cette commande abrégée si votre déploiement dépend d'autres fichiers de configuration ; ajoutez-la jibri.ymlplutôt à votre commande Compose habituelle. Le guide Docker officiel de Jitsi mentionne également le répertoire de stockage Jibri et ses permissions d'écriture. Consultez le manuel correspondant à votre version pour connaître l'organisation actuelle des répertoires avant de modifier les permissions. Les déploiements existants peuvent utiliser une organisation différente.
Assurez-vous que les utilisateurs XMPP internes, les mots de passe et les paramètres de configuration de Jibri soient cohérents entre le web, Prosody, Jicofo et la configuration Jibri. Le projet Compose fournit des variables pour ces valeurs. Générez des mots de passe internes robustes en suivant la procédure documentée du déploiement lors de la configuration du service et protégez le fichier d'environnement. Ne régénérez pas les mots de passe de manière répétée sur un déploiement en cours d'exécution sans coordonner la configuration du composant correspondant.
3. Confirmez que Jibri est disponible
Une fois les conteneurs démarrés, examinez leur état et leurs journaux. Avec le nom de service standard de Docker Compose, par exemple :
docker compose ps
docker compose logs --tail=100 jibri
Le nom exact du service et les journaux peuvent varier selon la version. Consultez les journaux de Jitsi Meet, Jicofo, Prosody et Jibri pour détecter les erreurs d'authentification XMPP ou de découverte de serveur de réunion multiple (MUC). Lorsqu'un compte Jibri valide est enregistré auprès de Jicofo, l'interface de réunion permet de contrôler la diffusion en direct. Si l'interface indique que le service de diffusion est indisponible, la saisie d'une clé YouTube ne résoudra pas le problème de connexion Jibri sous-jacent.
Lancez une diffusion en direct de Jitsi Meet sur YouTube.
4. Créez le flux YouTube et protégez sa clé.
Dans YouTube Studio, sélectionnez Créer → Diffuser en direct , puis créez ou programmez un flux d'encodeur. Copiez la clé de diffusion depuis la salle de contrôle en direct. Cette clé est l'identifiant de destination de l'encodeur ; ne la collez pas dans une conversation publique, l'historique des commandes, une capture d'écran ou un fichier de configuration partagé. Si la clé est visible, changez-la dans YouTube Studio et mettez à jour l'encodeur.
Le flux de travail standard de Jibri avec Jitsi demande au modérateur une clé de flux une fois Jibri opérationnel. L'API Jibri décrit également un paramètre de clé de flux YouTube pour son fonctionnement en streaming. Si vous utilisez une intégration Jibri personnalisée, suivez les instructions de l'API et les contrôles d'accès de la version déployée, plutôt que d'improviser un appel de point de terminaison.
5. Lancez la diffusion et vérifiez l'aperçu avant de passer en direct.
Rejoignez la réunion en tant que modérateur, ouvrez les commandes de la réunion et sélectionnez l'option de diffusion en direct si elle est disponible. Saisissez la clé de diffusion YouTube et lancez la diffusion. Dans la salle de contrôle YouTube Live, attendez l'aperçu et vérifiez que l'audio et la vidéo sont présents avant de sélectionner « Lancer la diffusion » . L'intitulé exact des boutons peut varier selon les versions de Jitsi ou les interfaces personnalisées.
Pour un premier test, créez un flux non répertorié et utilisez une courte réunion avec des mouvements et des interventions vocales. Vérifiez l'équilibre des intervenants, la lisibilité de l'écran partagé et le recadrage correct des vignettes des participants. YouTube transcode automatiquement les flux compatibles pour les appareils des spectateurs, mais la qualité du flux et la fiabilité du chemin de chargement restent essentielles. Surveillez les indicateurs de qualité du flux YouTube pendant les tests et l'événement.
Utilisez OBS lorsque vous avez besoin de plus de contrôle.
Avec OBS, rejoignez la réunion Jitsi sur un ordinateur dédié, capturez la fenêtre de réunion ou une scène spécifique, puis configurez l'URL du serveur YouTube et la clé de diffusion dans les paramètres de streaming d'OBS. Si vous souhaitez masquer les commandes de réunion, les notifications ou les informations privées des participants, créez et testez une scène vierge avant l'événement. Capturez uniquement le contenu que vous êtes autorisé à diffuser et informez les participants que leur audio et leur vidéo peuvent être diffusés.
OBS vous permet de contrôler la mise en page, les superpositions, les sources audio et les paramètres de sortie. Les recommandations actuelles de YouTube concernant l'encodage prennent en charge l'ingestion RTMP/RTMPS et recommandent RTMPS pour une connexion chiffrée. Pour le H.264 à 1080p30, YouTube indique un débit vidéo recommandé de 14 Mbit/s ; à 720p30, il indique 8 Mbit/s. Il s'agit de paramètres d'encodage cibles, et non de niveaux de qualité garantis. Prévoyez une marge de bande passante suffisante pour le trafic montant et choisissez une résolution ou un débit inférieur si votre connexion ne permet pas de maintenir le flux sans interruption.
Jibri est plus simple à configurer pour les modérateurs et conserve l'enregistrement sur le serveur, mais offre moins de contrôle sur la production lors du déroulement de réunion de base. OBS est plus flexible et facilite le choix d'une URL d'ingestion spécifique ou l'ajout d'éléments graphiques, mais nécessite la supervision d'un opérateur. Aucune des deux méthodes n'est universellement supérieure : utilisez Jibri pour les événements récurrents centralisés ; utilisez OBS pour les productions personnalisées ou lorsque la diffusion en temps réel et le contrôle des scènes sont requis.
Que faut-il vérifier si le flux ne démarre pas ?
- Le contrôle de la diffusion en direct est manquant : vérifiez si le déploiement a activé la diffusion en direct et si Jibri est enregistré et inactif. Pour Docker, vérifiez que la
ENABLE_RECORDINGconfiguration correspond à la version et que le service Jibri Compose est en cours d'exécution.
- Jitsi signale que la diffusion en continu est indisponible : veuillez consulter les journaux de Jibri ainsi que sa connexion XMPP, ses identifiants internes, le serveur de contrôle de la brasserie (MUC) et l’accès au stockage. Le problème se situe généralement entre les composants de contrôle de Jitsi et Jibri, avant même que YouTube ne reçoive la vidéo.
- YouTube ne reçoit aucun signal : vérifiez la clé de flux et le flux de destination, puis contrôlez la connectivité sortante de la machine exécutant l’encodeur. Faites pivoter une clé visible ou incertaine.
- YouTube affiche un aperçu, mais l'image saccade : réduisez la résolution ou le débit de sortie, vérifiez l'utilisation du processeur sur le serveur d'encodage et testez la bande passante montante soutenue. Pour Jibri, examinez la charge du serveur ; pour OBS, vérifiez les images perdues par l'encodeur et l'état du réseau.
- La vidéo s'affiche sans le son : vérifiez l'audio des participants Jitsi, la capture audio du système et le périphérique audio de l'encodeur sélectionné. Effectuez un test avec du son avant l'événement.
Liste de vérification avant l'événement
- La chaîne YouTube est éligible et l'événement en direct correspondant est ouvert dans la salle de contrôle en direct.
- Jibri est disponible, ou l'ordinateur et l'opérateur OBS sont prêts.
- La clé de flux est privée et appartient à l'événement concerné.
- Un aperçu test montre une parole claire, une vidéo stable et une mise en page lisible.
- Au moins un organisateur peut surveiller la qualité du flux YouTube et arrêter l'encodeur lorsque l'événement est terminé.
Références officielles