Documentation / Dépannage

Dépannage

Vous rencontrez un problème ? Retrouvez ci-dessous les solutions aux problèmes les plus courants. Chaque fiche décrit un symptôme précis et la manière de le résoudre.

Autorisations

« BetterStage ne parvient pas à contrôler mes fenêtres »

BetterStage a besoin de l’autorisation Accessibilité pour lire et déplacer les fenêtres. Ouvrez Réglages Système > Confidentialité et sécurité > Accessibilité et vérifiez que BetterStage figure dans la liste et qu’il est activé. S’il l’était déjà, essayez de le désactiver puis de le réactiver. Redémarrez BetterStage après avoir modifié l’autorisation. Si l’autorisation est révoquée pendant que BetterStage est en cours d’exécution, l’app vous alerte et restaure les fenêtres masquées au lieu de les laisser hors de l’écran. La révocation de l’Accessibilité ne permet plus à BetterStage de bloquer la saisie au clavier ou à la souris. L’accorder de nouveau n’interrompt pas une restauration en cours d’espace de travail enregistré, de continuité ou de sortie de veille.

« Les raccourcis ne fonctionnent pas »

BetterStage utilise l’API native de raccourcis Carbon pour les raccourcis clavier : aucune autorisation Surveillance de l’entrée n’est donc nécessaire. Si les raccourcis ne fonctionnent pas, vérifiez d’abord que l’autorisation Accessibilité est activée. Vérifiez aussi qu’aucune autre application n’utilise les mêmes combinaisons de touches, boutons de souris ou gestes du trackpad : des raccourcis en conflit empêchent BetterStage de recevoir les événements. Réaffectez les commandes du clavier, de la souris et du trackpad dans Réglages > Raccourcis.

« Les fenêtres ne sont pas détectées »

La détection des fenêtres repose sur l’API d’accessibilité de macOS, couverte par l’autorisation Accessibilité. Vérifiez qu’elle est activée dans Réglages Système > Confidentialité et sécurité > Accessibilité. Notez que certaines applications utilisent des types de fenêtres non standard (comme des panneaux flottants ou des fenêtres Chrome personnalisées) que l’API d’accessibilité peut ne pas détecter.

Comportement des fenêtres

« Dois-je utiliser BetterStage avec Stage Manager de macOS ? »

Non. Désactivez Stage Manager, intégré à macOS, avant d’utiliser BetterStage. Les deux outils gèrent la visibilité des fenêtres : les utiliser ensemble peut provoquer des changements déroutants, des fenêtres masquées ou des fenêtres qui apparaissent au mauvais endroit. Ouvrez Réglages Système > Bureau et Dock > Stage Manager et désactivez Stage Manager, puis relancez BetterStage si l’espace de travail semble toujours incorrect.

« Les fenêtres Firefox/Chrome s’animent au lieu de s’ancrer instantanément »

Certains navigateurs (Firefox, Chrome et les apps basées sur Electron) activent un indicateur d’accessibilité appelé AXEnhancedUserInterface, qui anime les déplacements de fenêtres au lieu de les ancrer instantanément. BetterStage détecte et désactive automatiquement cet indicateur pour les apps concernées. Si les déplacements sont toujours animés, essayez de quitter puis de rouvrir le navigateur afin que BetterStage puisse réappliquer le correctif.

« Les fenêtres Firefox clignotent, résistent au placement ou suivent les changements de Stage avec retard »

Firefox gère ses fenêtres de façon non standard et ne se prête donc pas toujours à la gestion des fenêtres : vous pouvez voir des fenêtres clignoter brièvement, résister à un placement précis ou suivre les changements de Stage avec retard. Il s’agit d’un problème connu et nous continuons d’améliorer la compatibilité avec Firefox.

« Le Finder apparaît lorsque je passe à un Stage vide »

macOS peut activer le Finder lorsque l’application au premier plan n’a aucune fenêtre visible. BetterStage 2.2.0 masque les fenêtres individuellement dans un Space privé au lieu de masquer l’application entière. Si une fenêtre apparaît de manière inattendue dans un Stage vide, signalez-nous le nom de l’app et la séquence de changements de Stage ou de bureau qui l’a provoquée.

« Des fenêtres se sont retrouvées dans le mauvais Stage après une mise en veille ou l’économiseur d’écran »

Laissez la disposition des écrans se stabiliser. La disposition d’un écran mémorisé se rétablit d’elle-même ; si une invite de récupération apparaît, choisissez Restaurer l’espace de travail ou Conserver la disposition actuelle. Pour les fenêtres qui restent masquées après la suppression d’un bureau, ou qui se retrouvent hors de l’écran après un changement d’écran, utilisez Secourir les fenêtres dans la barre des menus. Si BetterStage indique que les Spaces de macOS sont indisponibles, attendez la fin de la transition de bureau et choisissez Réessayer. Redémarrez BetterStage si le problème persiste.

« Une boîte de dialogue ou une fenêtre flottante est bloquée derrière TabStack »

Ouvrez la Roue Snap et choisissez Ramener les fenêtres flottantes dans Plus d’actions. Les fenêtres flottantes et non suivies de ce moniteur passent alors au premier plan, sans modifier la disposition ni afficher les onglets masqués. Secourir les fenêtres récupère aussi les fenêtres que BetterStage a masquées dans des Spaces privés, y compris celles dont le bureau d’origine a été supprimé.

« Des fenêtres ont disparu après un plantage »

BetterStage enregistre les fenêtres déplacées dans des Spaces privés et exécute un outil de récupération distinct. Si BetterStage se ferme de manière inattendue, cet outil utilise ces enregistrements pour ramener les fenêtres masquées sur leurs bureaux enregistrés. Si des fenêtres manquent toujours, relancez BetterStage et utilisez Secourir les fenêtres. Un bureau supprimé ou un écran déconnecté peut nécessiter une destination de remplacement accessible.

Configuration de l’app

« Lancement depuis le terminal ou depuis le bundle .app »

Lorsque vous lancez BetterStage avec swift run dans un terminal, macOS associe l’autorisation d’Accessibilité à votre app de terminal plutôt qu’à BetterStage lui-même. Pour une gestion correcte des autorisations, avec BetterStage affiché sous son nom dans Réglages Système, compilez et lancez plutôt le bundle .app.

« La barre des Stages n’apparaît pas »

La barre des Stages s’ouvre via le bord actif (en déplaçant le pointeur vers le haut de l’écran) ou avec le raccourci clavier Opt+Up Arrow. Vérifiez que le bord actif est activé dans les Réglages. Si la barre des Stages n’apparaît toujours pas, vérifiez que BetterStage dispose bien de l’autorisation d’Accessibilité requise.

Sur les écrans intégrés de Mac dotés d’une encoche, Réglages > Stages > Barre des Stages > Éviter l’encoche de l’écran permet d’ignorer la zone de l’encoche tout en gardant actif le reste du bord supérieur.

« Moniteur non reconnu après reconnexion »

BetterStage reconnaît les moniteurs grâce à des caractéristiques matérielles comme le modèle et le numéro de série, et pas seulement grâce à l’identifiant d’écran attribué par macOS. Dans de rares cas, par exemple après une mise à jour de pilote ou avec un autre port ou adaptateur, ces caractéristiques changent. Essayez de déconnecter puis de reconnecter le moniteur, puis redémarrez BetterStage. Si le moniteur n’est toujours pas reconnu, reconfigurez-le dans Réglages > Écrans.

« ⌘Tab affiche toujours le sélecteur d’apps de macOS »

Le Sélecteur ⌘Tab de BetterStage est facultatif et désactivé par défaut. Activez Utiliser le ⌘Tab de BetterStage dans Réglages > Sélecteur ⌘Tab et vérifiez que Pro, l’essai ou un aperçu Pro quotidien est actif. Sans aperçus, il affiche les icônes des apps ; autorisez l’Enregistrement de l’écran pour obtenir des vignettes en direct. Consultez le guide du Sélecteur ⌘Tab.

« Mes Stages ne se chargent plus après un retour à la version 2.0.x »

Les Stages enregistrés par BetterStage 2.2 ne peuvent pas être ouverts par les versions antérieures. Si vous avez réinstallé la version 2.0.x, vos Stages ne se chargeront pas ; installez plutôt la dernière version depuis la page de téléchargement.

Signaler un bug

BetterStage tient un journal de diagnostic tournant, plafonné à 10 Mo, pour ne jamais saturer votre disque. Pour le joindre à un signalement de bug, cliquez sur l’icône de BetterStage dans la barre des menus et choisissez Afficher le journal de diagnostic… : le Finder s’ouvre sur le fichier journal, que vous pouvez faire glisser dans un message Discord, un ticket GitHub ou un e-mail.

Les versions publiées évitent la journalisation détaillée, qui capturerait les titres des fenêtres. Si vous reproduisez un problème et souhaitez une trace plus complète, utilisez une version beta ou candidate, capturez le journal, puis revenez ensuite au canal de diffusion habituel.

Besoin d’aide supplémentaire ?

Si votre problème n’est pas traité ci-dessus, contactez-nous et nous vous aiderons à tout remettre en ordre.