Sous Ubuntu, Microsoft Teams peut refuser le partage d’écran et afficher « couldn’t connect to camera ». En cause, le démarrage sous Wayland. Voici deux voies fiables : basculer en Xorg, ou rester en Wayland en passant par Teams Web dans Chrome/Chromium avec PipeWire.
Partage d’écran impossible dans Microsoft Teams sous Ubuntu
<h3>Vue d’ensemble de la question</h3>
<p>Un utilisateur Ubuntu ne parvient pas à partager son écran dans l’application Microsoft Teams : au clic sur « Partager », la fonction échoue et un message, trompeur, s’affiche parfois : « <em>couldn’t connect to camera</em> ». Malgré divers tutoriels testés, le blocage persiste.</p>
<h3>Réponse et solution</h3>
<h4>Cause principale</h4>
<p>Depuis les versions récentes, Ubuntu démarre par défaut sous <strong>Wayland</strong>, un protocole d’affichage moderne. Or, certains clients Teams pour Linux (notamment des variantes « Preview »/non finales ou des builds basés sur d’anciens frameworks) gèrent imparfaitement le partage d’écran sous Wayland. Résultat : la capture de l’écran ne s’initialise pas correctement et l’erreur affichée n’est pas toujours explicite.</p>
<h4>Solution proposée : forcer l’utilisation de Xorg</h4>
<ol>
<li>Ouvrez un terminal.</li>
<li>Sauvegardez votre configuration GDM3 (recommandé) :
<pre><code>sudo cp -a /etc/gdm3/custom.conf /etc/gdm3/custom.conf.bak</code></pre>
</li>
<li>Lancez l’édition sécurisée du fichier :
<pre><code>sudoedit /etc/gdm3/custom.conf</code></pre>
</li>
<li>Repérez la ligne suivante :
<pre><code>#WaylandEnable=false</code></pre>
Supprimez le <code>#</code> pour obtenir :
<pre><code>WaylandEnable=false</code></pre>
</li>
<li>Enregistrez puis fermez l’éditeur.</li>
<li>Redémarrez votre session graphique (vous serez déconnecté) :
<pre><code>sudo systemctl restart gdm3</code></pre>
<p><strong>Astuce :</strong> vous pouvez aussi simplement <em>redémarrer</em> l’ordinateur.</p>
</li>
<li>Reconnectez‑vous, rouvrez Teams et testez à nouveau le partage d’écran.</li>
</ol>
<p>Avec Xorg, la plupart des utilisateurs constatent un retour à la normale : partage d’écran stable et choix de la fenêtre/du bureau fonctionnels.</p>
<h4>Alternative sans modifier GDM3 : Teams Web sous Wayland</h4>
<p>Si vous souhaitez rester en Wayland, utilisez <strong>Teams Web</strong> dans Chrome ou Chromium (basés sur WebRTC) en vous assurant que l’infrastructure de capture est prête.</p>
<ol>
<li>Installez les composants nécessaires :
<pre><code>sudo apt updatesudo apt install -y pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-gnome
Sur KDE Plasma, remplacez xdg-desktop-portal-gnome par xdg-desktop-portal-kde. Redémarrez votre session utilisateur (ou la machine) pour charger proprement PipeWire et les portails XDG. Ouvrez Teams dans Chrome/Chromium, puis essayez le partage d’écran : la sélection d’un onglet, d’une fenêtre ou de l’écran devrait s’afficher.
Bon à savoir : les versions « classic » de Teams (paquet .deb officiel historique) se montrent en général plus robustes pour le partage que certaines previews. À défaut, Teams Web dans Chrome/Chromium avec PipeWire et les portails xdg-desktop-portal fournit une expérience fiable sous Wayland.
Vue rapide des options
| Contexte | Correctif recommandé | Avantages | Limites |
|---|---|---|---|
| Client Teams Linux instable en partage sous Wayland | Basculer en Xorg via WaylandEnable=false ou choix de session « Ubuntu on Xorg » | Compatibilité élevée avec les apps existantes, partage d’écran fiable | Fonctionnalités Wayland non disponibles pendant la session Xorg |
| Conservation de Wayland souhaitée | Teams Web dans Chrome/Chromium + PipeWire + xdg-desktop-portal | Partage d’écran natif via WebRTC, permissions fines, reste sur Wayland | Dépend du navigateur, quelques limitations selon l’onglet/le bureau |
Vérifier d’abord votre environnement
Avant de modifier quoi que ce soit, identifiez la pile d’affichage en cours d’utilisation.
- Quel protocole de session ?
echo $XDG_SESSION_TYPELa commande renvoiewaylandoux11(Xorg). - Services de capture actifs côté utilisateur ?
systemctl --user status pipewire systemctl --user status xdg-desktop-portalIls doivent être actifs (active/running) si vous restez en Wayland. - Permissions du système GNOME : Ouvrez Paramètres ▸ Confidentialité ▸ Écran et autorisez la capture d’écran pour Teams (ou pour le navigateur).
Méthode Xorg détaillée pas à pas
Si vous préférez éviter l’édition de fichier, une autre voie est disponible directement depuis l’écran de connexion GDM3.
- Déconnectez-vous de votre session.
- Sur l’écran de connexion, cliquez sur l’icône engrenage près du bouton « Se connecter ».
- Choisissez « Ubuntu on Xorg » (ou « GNOME on Xorg »), puis connectez-vous.
- Ouvrez Teams et testez le partage d’écran.
Si l’option n’apparaît pas, la bascule via /etc/gdm3/custom.conf décrite plus haut est la solution universelle sur Ubuntu GNOME.
Attention : la commande sudo systemctl restart gdm3 coupe immédiatement la session graphique. Sauvegardez vos travaux avant de l’exécuter.
Rester sous Wayland avec Teams Web
Wayland apporte une meilleure isolation et des sécurités accrues. Pour conserver ces avantages, l’usage de Teams dans Chrome/Chromium est conseillé.
- Mettre à jour le système :
sudo apt update && sudo apt upgrade - Installer/mettre à jour PipeWire et les portails XDG :
sudo apt install -y pipewire wireplumber \ xdg-desktop-portal xdg-desktop-portal-gnome - Redémarrer la session pour relancer les services utilisateurs.
- Dans Chrome/Chromium, valider les autorisations de capture lors du premier partage dans Teams Web.
Une fois ces briques en place, le partage d’écran fonctionne de manière fluide en Wayland : sélection du bureau, d’une fenêtre ou d’un onglet.
Vérifications système indispensables
- Version de Teams : les builds « classic » (
.deb) gèrent souvent mieux le partage que certaines previews. En cas de doute, basculez sur Teams Web pour isoler l’origine du problème. - Autorisations GNOME : dans Paramètres ▸ Confidentialité, activez « Enregistrer l’écran ». Vérifiez aussi les invites d’autorisations affichées par le navigateur.
- Cartes Nvidia : assurez-vous que le pilote propriétaire est correctement installé. Certaines configurations hybrides peuvent perturber la capture sous Wayland.
- Conflits de portails : évitez la cohabitation de plusieurs implémentations
xdg-desktop-portal(GNOME et KDE) simultanément actives. - Pare-feu et politiques d’entreprise : des règles restrictives peuvent bloquer la capture/screencast ou l’accès caméra/micro.
Tests pratiques pour valider la réparation
- Contrôler le type de session :
echo $XDG_SESSION_TYPE - Tester le partage dans une réunion test Teams (vous seul). Vérifier que la boîte de sélection s’ouvre et que la vignette de prévisualisation s’anime.
- Vérifier l’audio : le partage d’un onglet dans Chrome/Chromium permet le partage du son de l’onglet.
- Observer les logs des services si nécessaire :
journalctl --user -u xdg-desktop-portal -fLes erreurs de permission ou de portail apparaîtront clairement.
Pourquoi Wayland peut poser souci avec certains clients Teams
Le partage d’écran sous Wayland repose sur une architecture de portails : l’application demande une capture au service xdg-desktop-portal, lequel délègue la sélection à l’utilisateur, puis PipeWire fournit un flux vidéo sécurisé. Si le client n’implémente pas correctement ces interfaces (ou utilise une pile Electron/Chromium trop ancienne), la capture échoue — parfois sans message explicite. À l’inverse, Xorg, plus ancien, expose l’écran d’une manière largement compatible avec les applications non adaptées à Wayland.
Réversibilité et retour à Wayland
Si vous avez forcé Xorg et souhaitez revenir à la configuration par défaut, rétablissez le commentaire dans /etc/gdm3/custom.conf puis redémarrez GDM3 ou la machine.
sudoedit /etc/gdm3/custom.conf
# WaylandEnable=false ← remettre le dièse en début de ligne
sudo systemctl restart gdm3Au prochain démarrage, Ubuntu réutilisera Wayland si votre matériel le supporte.
Foire aux questions
<h4>Je ne vois pas l’option « Ubuntu on Xorg » à la connexion</h4>
<p>Cette option peut être masquée selon l’édition ou le gestionnaire d’affichage. Dans ce cas, modifiez <code>/etc/gdm3/custom.conf</code> comme décrit plus haut. Sur des variantes non GNOME (KDE/SDDM, etc.), la procédure de bascule vers Xorg diffère.</p>
<h4>Le message « couldn’t connect to camera » persiste</h4>
<ul>
<li>Dans <em>Paramètres ▸ Confidentialité ▸ Caméra</em>, autorisez la caméra pour Teams ou le navigateur.</li>
<li>Fermez totalement Teams (quittez l’icône de zone de notification), puis relancez.</li>
<li>Supprimez le cache de l’application (en dernier recours, et seulement si vous savez ce que vous faites). Pensez à sauvegarder vos données :
<pre><code>mv ~/.config/Teams ~/.config/Teams.bak 2>/dev/null || truemv \~/.config/Microsoft/Microsoft\ Teams \~/.config/Microsoft/MSTeams.bak 2>/dev/null || true
Les dossiers exacts varient selon la build.
<h4>Puis-je utiliser Firefox ?</h4>
<p>Firefox supporte la capture Wayland via les portails. Assurez-vous que la version utilisée active l’intégration Wayland et que les portails sont présents. Toutefois, pour Teams Web, Chrome/Chromium donne généralement les meilleurs résultats.</p>
<h4>Et dans une machine virtuelle ou via RDP ?</h4>
<p>Les environnements virtualisés ou les sessions à distance peuvent compliquer la capture. En cas d’échec, privilégiez Xorg dans la VM ou utilisez Teams Web côté hôte.</p>
<h4>Dois-je réinstaller Teams ?</h4>
<p>Ce n’est pas nécessaire dans la majorité des cas. Le problème vient surtout de la pile graphique. Essayez d’abord Xorg ou Teams Web + PipeWire.</p>Checklist prête à l’emploi
- Vérifier la session :
echo $XDG_SESSION_TYPE. - Si Wayland : installer/activer PipeWire +
xdg-desktop-portal, puis essayer Teams Web dans Chrome/Chromium. - Si vous préférez l’appli native : basculer en Xorg (écran de connexion ou
custom.conf). - Contrôler les autorisations : Confidentialité ▸ Écran et Caméra.
- Retester dans une réunion test, puis en production.
Encadré sécurité : récupération en cas d’erreur GDM
Si, après modification de custom.conf, l’écran graphique ne revient pas :
- Basculer sur une console TTY (Ctrl+Alt+F3), se connecter.
- Restaurer la sauvegarde :
sudo cp -a /etc/gdm3/custom.conf.bak /etc/gdm3/custom.conf sudo systemctl restart gdm3 - Redémarrer la machine si nécessaire :
sudo reboot
Informations complémentaires utiles
- Version de Teams : lorsque c’est possible, préférez un build « classic » réputé plus stable pour le partage d’écran que certaines préversions.
- Alternative sans changement système : Teams Web sous Chrome/Chromium fonctionne sous Wayland grâce à WebRTC et aux portails XDG.
- Rester sous Wayland ? Installez
pipewireetxdg-desktop-portal(avec leur back‑end GNOME/KDE). Sur Ubuntu récents, la combinaison Teams Web + Chrome + PipeWire rend le partage d’écran opérationnel. - Autorisations : accordez à Teams (ou au navigateur) le droit « Enregistrer l’écran » depuis Paramètres ▸ Confidentialité ▸ Écran.
Commandes utiles récapitulatives
| Objectif | Commande | Résultat attendu |
|---|---|---|
| Identifier la session | echo $XDG_SESSION_TYPE | wayland ou x11 |
| Vérifier PipeWire | systemctl --user status pipewire | Service actif |
| Vérifier le portail XDG | systemctl --user status xdg-desktop-portal | Service actif |
| Installer la pile Wayland côté utilisateur | sudo apt install pipewire wireplumber xdg-desktop-portal xdg-desktop-portal-gnome | Composants présents |
| Basculer définitivement en Xorg | sudoedit /etc/gdm3/custom.conf puis WaylandEnable=false | Session Xorg au prochain lancement |
| Relancer l’affichage | sudo systemctl restart gdm3 | Retour à l’écran de connexion |
Conclusion
Lorsque Microsoft Teams refuse le partage d’écran sous Ubuntu en affichant « couldn’t connect to camera », le plus souvent c’est l’incompatibilité Wayland du client qui est en cause. Deux approches résolvent le problème de façon fiable : passer temporairement en Xorg pour l’application native, ou rester en Wayland en utilisant Teams Web dans Chrome/Chromium avec PipeWire + xdg-desktop-portal. Choisissez la voie adaptée à votre contexte (matériel, contraintes de sécurité, politiques d’entreprise) et conservez cette page comme mémo opérationnel.