Dépannage

Si vous rencontrez un problème avec OpenShot, comme un gel, un plantage ou un message d’erreur, plusieurs techniques peuvent être utiles pour résoudre le problème.

Utiliser les journaux pour résoudre un problème

Un journal est un fichier texte qui enregistre ce que fait OpenShot, ainsi que les avertissements et erreurs. Ces fichiers peuvent aider l’équipe de support à comprendre un problème, même lorsque vous ne voyez pas de message d’erreur à l’écran.

OpenShot conserve deux fichiers journaux dans le dossier .openshot_qt situé dans votre dossier personnel. Sous Linux et macOS, cet emplacement s’écrit ~/.openshot_qt/. Le dossier peut être caché dans votre gestionnaire de fichiers.

Les deux fichiers journaux
Fichier	Ce qu’il enregistre
`openshot-qt.log`	Activité dans l’éditeur : démarrage d’OpenShot, chargement des projets, modification des paramètres et utilisation de l’interface. C’est généralement le meilleur point de départ pour enquêter sur un problème.
`libopenshot.log`	Activité dans le moteur vidéo et audio d’OpenShot, la partie qui lit les médias et construit les images et sons utilisés dans les aperçus et les vidéos exportées. Un journal détaillé du moteur peut aider à enquêter sur les problèmes de lecture et d’exportation.

Ces fichiers enregistrent différentes parties de la même application. Lors de la déclaration d’un problème, incluez les deux fichiers si possible. Vous n’avez pas besoin de comprendre chaque ligne vous-même.

Choisissez quelle partie d’OpenShot enregistrer

Ouvrez Édition → Préférences → Avancé pour trouver ces deux paramètres :

Préférences et options correspondantes du terminal
Préférence	Argument correspondant	Fichier journal
Journalisation de débogage de l’interface utilisateur	`--debug-ui`	`openshot-qt.log`
Journalisation de débogage du moteur vidéo et audio	`--debug-engine`	`libopenshot.log`

Les deux préférences sont désactivées par défaut, ce qui conserve les messages de résumé normaux. Activer l’une d’elles ajoute immédiatement des détails à son fichier journal. Cela ne modifie pas l’autre journal ni n’ajoute de messages au terminal. Les préférences restent activées entre les lancements jusqu’à ce que vous les désactiviez.

La journalisation de débogage de l’interface utilisateur est un bon point de départ pour les problèmes de démarrage, de chargement de projet, de paramètres ou d’interface. La journalisation de débogage du moteur vidéo et audio ajoute des détails sur le traitement vidéo et audio, ce qui peut aider à enquêter sur les problèmes de lecture et d’exportation. Les journaux du moteur peuvent rapidement devenir volumineux et ralentir OpenShot. Activez ce paramètre peu avant de reproduire le problème, puis désactivez-le ensuite.

La préférence du moteur s’appelait auparavant Mode débogage (verbeux). Son réglage activé/désactivé enregistré est conservé sous le nouveau nom.

Utiliser un terminal pour un lancement

Un terminal est une fenêtre où vous tapez des commandes. Les arguments correspondants activent les mêmes détails supplémentaires que les préférences, et les affichent également dans le terminal :

openshot-qt --debug-ui

Cela enregistre les détails de l’interface pour un lancement. Les options familières --debug et la plus courte -d signifient exactement la même chose que --debug-ui. Pour les détails du moteur vidéo et audio, utilisez :

openshot-qt --debug-engine

Pour collecter les deux types de détails ensemble :

openshot-qt --debug-ui --debug-engine

Répétez les étapes qui causent le problème, puis fermez OpenShot et récupérez les journaux. Ces arguments ne modifient pas vos préférences enregistrées. Démarrer OpenShot normalement revient à vos paramètres habituels de journalisation.

openshot-qt.log crée un nouveau fichier lorsqu’il atteint environ 25 Mo et conserve trois copies plus anciennes. libopenshot.log continue de croître à mesure que des messages sont ajoutés. Après avoir sauvegardé les journaux nécessaires, vous pouvez supprimer les anciens fichiers journaux pendant qu’OpenShot est fermé.

Autres options en ligne de commande

La plupart des utilisateurs n’ont besoin que des deux contrôles ci-dessus. Les options suivantes vous permettent de choisir la quantité de détails à inclure dans les fichiers ou à afficher dans le terminal. Ici, console signifie la sortie du terminal.

Options de journalisation
Option	Ce que cela fait
`--debug-ui`, `--debug`, ou `-d`	Active la journalisation de débogage de l’interface utilisateur dans son fichier et dans le terminal.
`--debug-engine`	Active la journalisation de débogage du moteur vidéo et audio dans son fichier et dans le terminal.
`--debug-file`	Ajoute des détails de l’éditeur à `openshot-qt.log` sans ajouter de détails dans le terminal.
`--debug-console`	Ajoute des détails de l’éditeur dans le terminal sans ajouter de détails dans le fichier.
`--log-level LEVEL`	Définit le niveau de détail pour les deux journaux et leur sortie dans le terminal.
`--log-file-level LEVEL`	Définit le niveau de détail pour les deux fichiers journaux, sans modifier les paramètres du terminal.
`--log-console-level LEVEL`	Définit le niveau de détail dans le terminal pour l’éditeur et le moteur, sans modifier les paramètres des fichiers.

Remplacez LEVEL par debug pour des messages détaillés ou info pour le résumé normal. warning affiche les avertissements et erreurs ; error affiche les erreurs et défaillances critiques ; critical affiche uniquement les défaillances critiques. off arrête les messages ordinaires, mais les diagnostics de plantage existants peuvent toujours être écrits. Les noms en majuscules comme DEBUG fonctionnent aussi.

Par exemple, pour collecter des messages détaillés dans les deux fichiers tout en conservant le niveau habituel du terminal :

openshot-qt --log-file-level debug

Cela active également le journal détaillé du moteur, utilisez-le donc brièvement. Les anciennes options --debug-file et --debug-console fonctionnent toujours même si elles ne sont pas listées dans --help.

Variables d’environnement

Une variable d’environnement est un paramètre nommé transmis à un programme au démarrage. Elles sont utiles lors du lancement d’OpenShot depuis un script ou lorsqu’un support vous demande d’essayer un paramètre particulier. Vous n’avez pas besoin de les définir pour une utilisation normale.

Paramètres d’environnement optionnels
Variable	Ce qu’elle contrôle
`OPENSHOT_LOG_LEVEL`	Détail dans les deux fichiers et le terminal.
`OPENSHOT_LOG_FILE_LEVEL`	Détail uniquement dans les deux fichiers.
`OPENSHOT_LOG_CONSOLE_LEVEL`	Détail uniquement dans le terminal, pour les deux parties d’OpenShot.
`LIBOPENSHOT_LOG_LEVEL`	Détail pour le moteur vidéo et audio, dans son fichier et le terminal.
`LIBOPENSHOT_LOG_FILE_LEVEL`	Détail uniquement dans `libopenshot.log`.
`LIBOPENSHOT_LOG_CONSOLE_LEVEL`	Détail du moteur uniquement dans le terminal.

Par exemple, cette commande terminal Linux/macOS demande un journal détaillé du moteur dans son fichier pour un lancement :

LIBOPENSHOT_LOG_FILE_LEVEL=debug openshot-qt

Si les paramètres se chevauchent, les options en ligne de commande ont la priorité, suivies des variables d’environnement, puis des Préférences, puis des valeurs par défaut normales. Chaque contrôle n’affecte que la sortie qu’il décrit : --debug ne remplace pas la préférence du moteur. Les remplacements temporaires ne modifient pas vos préférences enregistrées. Survolez une case à cocher pour voir si un autre paramètre contrôle ce fichier journal.

Dans les paramètres d’environnement, les valeurs LIBOPENSHOT_ ont la priorité sur les valeurs OPENSHOT_ pour le moteur. Dans chaque groupe, un niveau fichier uniquement ou console uniquement a la priorité sur le niveau général. Les options en ligne de commande suivent la même règle fichier/console. Les niveaux conflictuels en ligne de commande pour la même sortie sont rejetés ; les niveaux d’environnement invalides sont signalés et ignorés.

Pour les anciens scripts, LIBOPENSHOT_DEBUG active toujours les messages détaillés du moteur dans le terminal lorsqu’il est présent, même si sa valeur est 0. Les nouveaux paramètres de niveau ont la priorité sur celui-ci. LIBOPENSHOT_LOG_FILE est destiné aux programmes utilisant le moteur séparément ; OpenShot utilise lui-même le dossier de journal ci-dessus. Modifier les paramètres de journalisation ne change pas votre préférence de rapport d’erreurs.

Windows 11 ne répond pas

Si vous subissez un gel sous Windows 11, c’est un problème connu lié à PyQt5 et Windows 11, concernant les fonctionnalités d’accessibilité de Qt. Cela se produit en appuyant sur Ctrl+C dans OpenShot (uniquement sous Windows 11). OpenShot devient alors non réactif et une fuite mémoire est également présente (c’est-à-dire que plus OpenShot reste non réactif, plus la fuite mémoire s’aggrave jusqu’à ce qu’OpenShot plante ou que l’utilisateur termine le processus).

Une solution simple consiste à éviter Ctrl+C sous Windows 11, et à utiliser à la place les menus Copier/Coller du clic droit. Une autre solution est de remapper la commande « Copier » de Ctrl+C vers une autre combinaison, par exemple Alt+C. Vous pouvez modifier vos raccourcis clavier dans les Préférences d’OpenShot. Voir Clavier.

Débogage sous Windows avec GDB

Si vous rencontrez un plantage ou un gel avec OpenShot sous Windows 10/11, les instructions suivantes étape par étape vous aideront à déterminer la cause du plantage. Ces instructions afficheront une trace de la pile du code source d’OpenShot, à l’endroit du plantage. Ces informations sont extrêmement utiles pour notre équipe de développement, et très utiles à joindre aux rapports de bugs (pour une résolution plus rapide).

Installer la dernière version quotidienne

Avant d’attacher un débogueur, veuillez télécharger la dernière version d’OpenShot : https://www.openshot.org/download#daily. Installez cette version d’OpenShot à l’emplacement par défaut : C:\Program Files\OpenShot Video Editor\. Pour des instructions détaillées sur le débogage d’OpenShot sous Windows, veuillez consulter ce wiki.

Installer MSYS2

La version Windows d’OpenShot est compilée avec un environnement appelé MSYS2. Pour attacher le débogueur GDB à notre exécutable, openshot-qt.exe, vous devez d’abord installer MSYS2. Cette étape n’est requise qu’une seule fois.

Téléchargez et installez MSYS2 : http://www.msys2.org/
Lancez l’invite de commandes MSYS2 MinGW x64 (par exemple : C:\msys64\msys2_shell.cmd -mingw64)
Mettez à jour tous les paquets (Copiez/Collez la commande suivante):
```
pacman -Syu
```

Installez le débogueur GDB (Copiez/Collez la commande suivante):

pacman -S --needed --disable-download-timeout mingw-w64-x86_64-toolchain

Lancez OpenShot avec le débogueur GDB

Lancez l’invite de commandes MSYS2 MinGW x64 (par exemple : C:\msys64\msys2_shell.cmd -mingw64)

Mettez à jour le PATH (Copiez/Collez les commandes suivantes):

export PATH="/c/Program Files/OpenShot Video Editor/lib:$PATH"
export PATH="/c/Program Files/OpenShot Video Editor/lib/PyQt5:$PATH"

Chargez OpenShot dans le débogueur GDB (Copiez/Collez les commandes suivantes):

cd "/c/Program Files/OpenShot Video Editor"/
gdb openshot-qt.exe

Lancez OpenShot depuis l’invite GDB (Copiez/Collez la commande suivante):

run --debug

Afficher les informations de débogage

Une fois qu’OpenShot est lancé avec GDB attaché, il vous suffit de provoquer un plantage ou un gel dans OpenShot. Lorsqu’un plantage survient, revenez au terminal MSYS2 MinGW64 et exécutez l’une des commandes suivantes (en la tapant puis en appuyant sur ENTRÉE). En général, la première commande à saisir est bt, qui signifie backtrace. D’autres commandes sont listées ci-dessous.

(gdb) run            (launch openshot-qt.exe)
(gdb) CTRL + C       (to manually break out   OR   wait for a crash / segmentation fault)
(gdb) bt             (Print stack trace for the current thread #)
(gdb) info threads   (to view all threads, and what they are doing. Look for `__lll_lock_wait` for Mutex/deadlocks)
(gdb) thread 35      (Switch to thread number, for example thread 35)

Moniteurs Haute DPI / 4K

OpenShot Video Editor offre un support robuste pour les moniteurs Haute DPI (points par pouce), garantissant que l’interface est nette et facilement lisible sur des écrans avec différents réglages DPI. Ce support est particulièrement utile sur les moniteurs 4K et autres écrans à haute résolution.

Sensibilité DPI par moniteur

OpenShot est conscient du DPI pour chaque moniteur, ce qui signifie qu’il peut ajuster son échelle dynamiquement en fonction des réglages DPI de chaque moniteur connecté. Cela permet d’offrir une expérience cohérente sur différents écrans.

Mise à l’échelle DPI sous Windows

Sous Windows, OpenShot arrondit le facteur d’échelle à la valeur entière la plus proche pour préserver l’intégrité visuelle. Cela aide à éviter les artefacts visuels dans l’interface et maintient les éléments nets et bien alignés. En raison de cet arrondi, certaines options d’échelle peuvent entraîner des polices et éléments d’interface plus grands que prévu.

L’échelle à 125% est arrondie à 100%
L’échelle à 150% est arrondie à 200%

Solutions de contournement pour un réglage précis

Bien que l’arrondi aide à maintenir une interface propre, il existe des solutions de contournement pour les utilisateurs qui nécessitent un contrôle plus précis de l’échelle. Ces méthodes ne sont pas recommandées en raison des artefacts visuels potentiels :

QT_SCALE_FACTOR_ROUNDING_POLICY=PassThrough
- Définir cette variable d’environnement peut désactiver l’arrondi et permettre une mise à l’échelle plus précise.
- Note : Cela peut provoquer des artefacts visuels, notamment dans la timeline, et n’est pas recommandé.
QT_SCALE_FACTOR=1.25 (ou une valeur similaire)
- Définir manuellement le facteur d’échelle peut offrir des ajustements plus fins de la taille des polices et de l’interface.
- Cela peut également être configuré via les Préférences (Échelle de l’interface utilisateur), mais attendez-vous à des problèmes de bordures/lignes sous Windows avec des échelles fractionnaires.
- Note : Cette méthode peut aussi entraîner des artefacts visuels et rendre OpenShot plus difficile à utiliser.

Pour plus d’informations sur l’ajustement de ces variables d’environnement, veuillez visiter https://github.com/OpenShot/openshot-qt/wiki/OpenShot-UI-too-large.