DTLdesktop — Guide utilisateur v1.1-1
Guide pratique pour capturer, reconnaître et restaurer une configuration de bureau Windows avec DTLdesktop.
Préface
Objet du guide
Ce guide explique comment utiliser DTLdesktop pour capturer, reconnaître et restaurer une configuration de bureau Windows : disposition et orientation des écrans, fond d'écran de chaque moniteur et position de chaque icône. Il couvre le mode interactif, les options en ligne de commande, la lecture des diagnostics affichés à l'écran, ainsi qu'un ensemble de scénarios courants.
Pour la description fonctionnelle de l'outil, la raison pour laquelle il a été créé et le détail de son fonctionnement interne, consultez le Manuel de référence DTLdesktop.
Audience visée
Ce guide s'adresse à toute personne qui utilise DTLdesktop au quotidien sur un poste multi-écrans : administrateurs de postes de travail, personnel de support amené à restaurer un bureau après une intervention matérielle, et mainteneurs de la suite NetDTL. Aucune connaissance de programmation n'est requise.
Rappel : qu'est-ce que DTLdesktop
DTLdesktop enregistre, sous la forme d'un profil, l'état d'un bureau Windows : disposition et orientation des écrans, fond d'écran de chaque moniteur, position de chaque icône. Il reconnaît ensuite automatiquement une configuration déjà connue, y compris après une permutation physique d'écrans, et restaure en une seule opération vérifiée l'ensemble de cet état. Ce rappel est volontairement bref ; le pourquoi et le fonctionnement interne sont développés dans le manuel de référence.
Prise en main
Lancement
DTLdesktop se lance sans argument pour ouvrir le mode interactif, décrit dans la section suivante. Lancé avec une option (par exemple --auto ou --diagnose), il exécute directement l'action correspondante puis se termine, sans afficher de menu ; c'est le mode non interactif, présenté plus loin dans ce guide.
Écran d'accueil et détection
Au lancement, DTLdesktop efface l'écran, affiche son en-tête, puis détecte la configuration d'écrans effectivement branchée à cet instant. Pour chaque moniteur, il affiche la résolution, l'orientation et, s'il s'agit de l'écran principal, la mention correspondante ; il affiche ensuite la disposition des écrans de gauche à droite.
DTLdesktop indique ensuite si cette configuration correspond à un profil déjà enregistré (Configuration sélectionnée : <nom du profil>) ou s'il s'agit d'une configuration qu'il ne reconnaît pas (Nouvelle configuration), auquel cas il propose un nom par défaut pour l'enregistrer.
Notion de profil
Un profil est l'enregistrement complet d'une configuration de bureau : la disposition des écrans, le fond d'écran de chacun pour ses deux orientations possibles, et la position de chaque icône du bureau. Chaque profil est un sous-dossier du dossier Desktop, situé à côté de l'application.
Nommage des profils
DTLdesktop attribue lui-même le nom d'un profil ; il n'existe pas d'option pour saisir un nom au clavier. Ce nom par défaut décrit le nombre d'écrans et leur orientation (par exemple SingleLandscape, DualPortrait, TripleMixed). Lorsqu'une configuration correspond exactement à un profil déjà enregistré, DTLdesktop réutilise le nom de ce profil.
Desktop depuis l'Explorateur Windows après l'avoir enregistré une première fois ; voir le scénario Distinguer deux configurations similaires.Reconnaissance automatique
À chaque lancement, DTLdesktop compare la configuration détectée aux profils enregistrés. Une correspondance exacte est reconnue même si Windows a renommé les écrans depuis l'enregistrement du profil, par exemple après une permutation physique de deux moniteurs. Si aucune correspondance exacte n'existe mais qu'un profil compatible est trouvé, DTLdesktop le retient également. En l'absence de toute correspondance, il affiche Nouvelle configuration.
Mode interactif
Vue du menu
Une fois la configuration détectée affichée, DTLdesktop propose le menu suivant, accessible en tapant la lettre correspondante puis en validant :
Le menu reste affiché après chaque action, ce qui permet d'enchaîner plusieurs opérations sans relancer l'outil.
Sauvegarder le profil actuel (S)
Enregistre l'état actuel du bureau — écrans, icônes et fonds d'écran — sous le nom de profil actuellement sélectionné (celui reconnu, ou celui proposé par défaut pour une nouvelle configuration). Si un profil de ce nom existe déjà, il est remplacé par l'état courant. DTLdesktop confirme le nombre d'icônes et d'écrans enregistrés.
Appliquer un profil (A)
Propose la liste des profils enregistrés, demande d'en choisir un par son numéro, puis indique combien d'écrans verront leur orientation ou leur disposition modifiée par cette application. Après confirmation (O/N), DTLdesktop modifie dans l'ordre l'orientation et la résolution des écrans, les fonds d'écran, puis la position des icônes, et vérifie que le résultat correspond au profil. En cas d'échec de cette vérification, DTLdesktop tente automatiquement de revenir à l'état qui précédait l'opération et affiche le message d'erreur correspondant.
Restaurer les icônes seules (R)
Propose la liste des profils enregistrés, affiche un aperçu de ce qui serait modifié (icônes déplacées, absentes ou nouvelles) sans rien appliquer, puis demande confirmation. Après confirmation, seules les positions des icônes du bureau sont restaurées à partir du profil choisi ; la disposition des écrans et les fonds d'écran ne sont pas modifiés. DTLdesktop indique le nombre d'icônes restaurées et signale celles du profil qui sont introuvables sur le bureau actuel.
Diagnostiquer (D)
Affiche la configuration d'écrans détectée. Si elle correspond à un profil connu, DTLdesktop affiche également le diagnostic des fonds d'écran de ce profil, écran par écran (voir Lire le diagnostic des fonds d'écran). Si un ou plusieurs fonds d'écran sont incohérents, DTLdesktop propose de les corriger immédiatement ; seuls les fonds d'écran sont alors modifiés, ni les icônes ni la disposition des écrans. Si la configuration n'est pas reconnue, DTLdesktop indique qu'il s'agit d'une nouvelle configuration et invite à l'enregistrer avec S.
Choisir les fonds d'écran (F)
Ouvre, pour chaque écran détecté, le sélecteur de fichiers de Windows afin de choisir une image de fond d'écran ; le dossier d'image ouvert par défaut est celui utilisé lors de la dernière sélection. Annuler la sélection pour un écran conserve son fond actuel. Les fonds choisis sont appliqués immédiatement au bureau, en mode « Remplir ».
Tester et comparer (T / C)
Ces deux lettres déclenchent la même action : proposer la liste des profils enregistrés, puis afficher, pour le profil choisi, une comparaison avec l'état actuel du bureau — écrans identiques ou différents, nombre d'icônes déplacées, absentes ou nouvelles, nombre de fonds d'écran incohérents. Aucune modification n'est appliquée ; cette action sert uniquement à examiner un écart avant de décider d'une correction avec A ou R.
Quitter (Q)
Ferme DTLdesktop sans effectuer de dernière action.
Mode non interactif
Vue d'ensemble
Chaque option ci-dessous exécute une seule action puis termine DTLdesktop, sans afficher le menu. Ce mode est destiné à une intégration à un script de démarrage, une tâche planifiée, ou tout appel automatisé.
--auto
Restaure automatiquement le profil reconnu pour la configuration détectée — équivalent à choisir A sur le profil reconnu, sans confirmation. Si aucun profil compatible n'est trouvé, DTLdesktop l'indique et ne modifie rien.
--save
Enregistre la configuration détectée sous le nom reconnu ou proposé par défaut, sans demander de confirmation ni de nom — équivalent à S en mode interactif.
--apply <profil>
Applique le profil désigné : orientation, résolution, fonds d'écran et icônes — équivalent à A suivi de la sélection de ce profil et de la confirmation.
--restore <profil>
Restaure uniquement les icônes du profil désigné, sans toucher à la disposition des écrans ni aux fonds d'écran — équivalent à R suivi de la sélection de ce profil et de la confirmation.
--test <profil>
Affiche la comparaison entre l'état actuel du bureau et le profil désigné, sans rien modifier — équivalent à T ou C.
--diagnose
Affiche la configuration détectée et, si elle correspond à un profil connu, le diagnostic de ses fonds d'écran — équivalent à D, sans proposer de correction.
--version affiche uniquement le numéro de version de DTLdesktop.
Codes de sortie
| Code | Signification |
|---|---|
| 0 | Action effectuée sans erreur. |
| 1 | Une erreur a interrompu l'action (voir Messages d'erreur courants). |
| 2 | --auto uniquement : aucun profil compatible n'a été trouvé pour la configuration détectée. |
Scénarios courants
Premier profil sur un poste
- Branchez et disposez les écrans comme souhaité, réglez leur orientation dans Windows si nécessaire.
- Lancez DTLdesktop. La configuration est détectée et annoncée comme nouvelle.
- Si besoin, choisissez le fond d'écran de chaque moniteur avec F.
- Enregistrez avec S. Le profil est créé sous le nom proposé par défaut.
Fond d'écran différent selon l'orientation d'un écran
Pour un écran que vous faites parfois pivoter entre paysage et portrait, DTLdesktop peut appliquer automatiquement un fond différent selon l'orientation effective.
- Orientez l'écran en paysage, choisissez son fond avec F, puis enregistrez avec S.
- Faites pivoter l'écran en portrait. DTLdesktop détecte la nouvelle orientation au lancement suivant.
- Choisissez le fond correspondant à l'orientation portrait avec F, puis enregistrez à nouveau avec S.
Les deux fonds sont désormais conservés dans le même profil ; chacun est réappliqué automatiquement selon l'orientation détectée lors d'une restauration.
Restaurer après une permutation physique de deux écrans
Après avoir physiquement échangé la place de deux moniteurs, Windows peut inverser leurs noms de périphérique et redistribuer les icônes.
- Lancez DTLdesktop. Grâce à la signature géométrique du profil, la configuration reste reconnue malgré le changement de nommage.
- Appuyez sur A, sélectionnez le profil reconnu, confirmez.
- DTLdesktop remet en place l'orientation de chaque écran, ses fonds d'écran et la position de ses icônes.
Corriger un fond d'écran isolé sans tout réappliquer
- Appuyez sur D. DTLdesktop affiche, écran par écran, si le fond observé correspond au fond attendu par le profil reconnu.
- Si un écart est signalé, répondez O à l'invite de correction. Seuls les fonds d'écran non conformes sont corrigés.
Cette action ne touche ni à la disposition des écrans ni à la position des icônes.
Restauration automatique à l'ouverture de session
L'option --auto est destinée à un appel automatisé, par exemple depuis une tâche exécutée à l'ouverture de session ou depuis un script de démarrage de poste. Elle restaure sans confirmation le profil reconnu pour la configuration présente à ce moment, ce qui permet de retrouver disposition, fonds d'écran et icônes sans intervention manuelle.
Distinguer deux configurations similaires
Deux dispositions physiquement différentes mais de même type (même nombre d'écrans, mêmes orientations) reçoivent le même nom de profil par défaut. Pour les conserver séparément :
- Enregistrez la première configuration avec S.
- Dans l'Explorateur Windows, renommez le sous-dossier correspondant sous
Desktoppour lui donner un nom distinctif. - Installez-vous dans la seconde configuration, puis enregistrez-la avec S : elle crée un nouveau profil sous le nom par défaut, sans écraser le profil renommé.
Messages et diagnostics
Messages d'erreur courants
| Message | Signification et action |
|---|---|
| Le bureau Windows est introuvable. Redémarrez l'Explorateur Windows puis réessayez. | DTLdesktop n'a pas pu localiser la liste des icônes du bureau. Redémarrez l'Explorateur Windows (par exemple depuis le Gestionnaire des tâches) et relancez l'action. |
| Accès aux icônes refusé. Lancez DTLdesktop avec le même niveau de droits que l'Explorateur Windows. | DTLdesktop n'a pas pu accéder au processus de l'Explorateur. Relancez DTLdesktop avec le niveau de droits habituel de la session (évitez de le lancer en tant qu'administrateur si l'Explorateur ne l'est pas, et inversement). |
| La nouvelle orientation n'a pas été confirmée par Windows. | Windows n'a pas appliqué le changement d'affichage dans le délai attendu lors d'une application de profil (A ou --apply). DTLdesktop tente un retour à l'état précédent ; réessayez ensuite l'application du profil. |
| La nouvelle configuration n'a pas pu être validée : <détail> La configuration précédente a été restaurée. | La vérification qui suit l'application d'un profil a échoué, mais le retour automatique à l'état antérieur a réussi. Le bureau se retrouve dans l'état qui précédait la tentative. |
| Le retour automatique n'a pas pu être entièrement validé. | La vérification a échoué et le retour automatique à l'état antérieur n'a pas pu être confirmé non plus. Vérifiez manuellement l'état du bureau, puis relancez D pour un diagnostic. |
| Le profil « <nom> » est incomplet ou illisible. | Les fichiers du profil désigné sont absents ou corrompus. Choisissez un autre profil, ou enregistrez-en un nouveau avec S. |
Lire le diagnostic des fonds d'écran
Pour chaque écran, le diagnostic affiché par D indique sa résolution, son orientation, le fond d'écran actuellement observé, puis une conclusion :
✓ conforme: le fond observé correspond au fond attendu par le profil pour l'orientation actuelle de l'écran.⚠ fond d'écran incohérent: le fond observé diffère du fond attendu ; les deux noms de fichier sont affichés pour comparaison.
Annexes
Aide-mémoire du menu interactif
| Touche | Action | Modifie le bureau |
|---|---|---|
| A | Appliquer un profil (écrans, fonds, icônes) | Oui |
| S | Sauvegarder le profil actuel | Non (enregistre l'existant) |
| R | Restaurer les icônes seules | Oui, icônes uniquement |
| D | Diagnostiquer, avec correction optionnelle des fonds d'écran | Optionnel, fonds d'écran uniquement |
| T / C | Tester / Comparer un profil | Non |
| F | Choisir les fonds d'écran | Oui, fonds d'écran uniquement |
| Q | Quitter | Non |
Aide-mémoire des options en ligne de commande
| Option | Effet |
|---|---|
| (aucune) | Ouvre le mode interactif. |
| --auto | Restaure sans confirmation le profil reconnu. |
| --save | Enregistre la configuration détectée sous le nom reconnu ou par défaut. |
| --apply <profil> | Applique intégralement le profil désigné. |
| --restore <profil> | Restaure uniquement les icônes du profil désigné. |
| --test <profil> | Affiche une comparaison sans rien modifier. |
| --diagnose | Affiche la configuration détectée et le diagnostic des fonds d'écran. |
| --version | Affiche le numéro de version. |
Emplacement des fichiers
Profils
Desktop/<nom du profil>/Un sous-dossier par profil enregistré, contenant monitors.json, icons.json et wallpaper.json.
Réglages
Desktop/settings.jsonProfil actif et dernier dossier d'image utilisé par le sélecteur de fond d'écran (F).