TUTORIEL_FR

📖 VPX Config Switcher — Tutoriel complet

Table des matières

1. Présentation du logiciel
2. Installation
3. Configuration au premier lancement
4. Comprendre les profils
5. Créer un nouveau profil — Guide complet
6. Gestion des PuPPacks
7. Activer un profil
8. Import et Export de profils
9. Mises à jour automatiques
10. Questions fréquentes (FAQ)
11. Signaler un bug / Contribuer

1. Présentation du logiciel

1.1 À quoi sert VPX Config Switcher ?

VPX Config Switcher est un gestionnaire de profils de configuration pour Visual Pinball X (VPX). Il permet de basculer instantanément entre plusieurs configurations très rapidement.

Sur un cabinet (pincab) ou un PC Desktop, changer de mode — par exemple passer du mode 2D au mode VR — oblige normalement à remplacer manuellement plusieurs fichiers de configuration : VPinballX.ini, DMDDevice.ini, Fichiers de configuration de PuPPacks et ScreenRes.txt. C'est fastidieux, source d'erreurs, et impossible à faire rapidement.

VPX Config Switcher automatise tout cela en un seul clic : il remplace les fichiers, bascule la sortie audio Windows et redirige les dossiers symboliques, en moins d'une seconde.

1.2 Ce que le logiciel gère

Fichiers de configuration (par profil) :

Élément	Description
`VPinballX.ini`	Fichier principal de configuration VPX (graphismes, résolutions, contrôles, physique…)
`DMDDevice.ini`	Configuration du périphérique DMD (affichage du score de type flipper réel)
`ScreenRes.txt`	Position et résolution des fenêtres VPX (playfield, backglass, DMD)
Sortie audio Windows	Le périphérique de sortie son actif (haut-parleurs cabinet, casque VR…)
Liens symboliques (Symlinks)	Redirection de dossiers comme PuPVideos vers une version 2D ou VR
Commandes personnalisées	Scripts ou exécutables à lancer automatiquement à l'activation du profil

Ce que le logiciel ne touche pas :

Les tables de flipper VPX
Les ROMs VPinMAME
PinUP Popper et ses configurations

1.3 Compatibilité


Système	Windows 10 / 11 — 64 bits uniquement
VPX	Toutes versions de Visual Pinball X (détection automatique)
Prérequis	Aucun — Python, PyQt6 et les outils audio sont embarqués dans l'exe

2. Installation

2.1 Téléchargement

Rendez-vous sur la page GitHub du projet : https://github.com/Nesta78/VPXConfigSwitcher puis cliquez sur l'onglet Releases dans la colonne de droite.

Téléchargez le fichier VPXConfigSwitcher.exe. Il n'y a rien à installer : c'est un exécutable portable.

2.2 Emplacement recommandé

Placez l'exe dans un dossier dédié, par exemple :

C:\Tools\VPXConfigSwitcher\VPXConfigSwitcher.exe

⚠️ Ne le placez PAS directement dans le dossier de VPX, ni dans un dossier système comme Program Files.

💡 Créez un raccourci sur votre bureau ou dans votre barre des tâches pour un accès rapide. Vous pouvez également choisir de laisser le .exe directement sur votre bureau.

2.3 Premier lancement

Double-cliquez sur VPXConfigSwitcher.exe. Lors du tout premier lancement, Windows peut afficher un avertissement SmartScreen. Cliquez sur « Informations complémentaires » puis sur « Exécuter quand même ».

📝 Cette alerte apparaît car l'exe n'est pas signé par un certificat commercial.

3. Configuration au premier lancement

À la première ouverture, VPX Config Switcher affiche un assistant de configuration initiale en deux étapes. Il est important de le compléter correctement avant de créer vos profils.

3.1 Étape 1 — Sélection des exécutables VPX

Ce qu'affiche cette fenêtre

Le logiciel scanne automatiquement votre PC pour détecter les versions de Visual Pinball X installées dans les dossiers courants (C:\vPinball, C:\Visual Pinball, etc.). Il liste toutes les versions trouvées avec leur chemin complet.

Que faire dans cette étape

Cochez les versions de VPX que vous souhaitez utiliser avec le switcher (ça servira à pouvoir régler vos paramètres directement dans Vpx et que ça sauvegarde vos modifications dans les fichiers de configuration)
Décochez les versions que vous ne voulez pas gérer (anciennes versions inutilisées, etc.).
Si une version n'est pas détectée automatiquement, cliquez sur "Ajouter manuellement" et naviguez jusqu'à l'exe VPX souhaité.
Cliquez sur "Valider" pour confirmer votre sélection.

📝 Vous pouvez revenir à cette liste à tout moment via le menu Préférences → Gérer les exécutables VPX.

⚠️ Si vous gérez plusieurs versions de VPX (par exemple VPX 10.8 et VPX 10.7), cochez-les toutes. Chaque profil pourra ensuite choisir avec quelle version de VPX il doit fonctionner. Par exemple, j'ai coché pour ma part la version Standard X64 pour le mode 2D, et la version GL_X64 pour le mode VR.

3.2 Étape 2 — Création du premier profil

Pourquoi créer un profil immédiatement

Avant de pouvoir switcher de configuration, il faut qu'il existe au moins un profil dans le logiciel. L'assistant vous guide pour créer votre premier profil à partir de votre configuration VPX actuelle — c'est-à-dire celle que vous utilisez déjà.

Ce premier profil sera votre point de référence. Il représente votre setup tel qu'il est en ce moment.

Comment capturer votre configuration actuelle

L'assistant vous propose de lire automatiquement les fichiers de configuration actuels :
- VPinballX.ini (détecté automatiquement depuis le dossier de l'exe VPX coché)
- DMDDevice.ini (si présent)
- ScreenRes.txt (si présent)
Cliquez sur "Lire la configuration actuelle" pour importer ces fichiers dans le profil.
Donnez un nom à votre profil (ex. : "2D Pincab" ou "Config actuelle").
Cliquez sur "Créer le profil" pour terminer.

📝 Vous n'êtes pas obligé de configurer toutes les options à cette étape. Vous pourrez le faire plus tard en éditant le profil si besoin.

3.3 Interface principale après la configuration initiale

Une fois l'assistant terminé, la fenêtre principale de VPX Config Switcher s'ouvre.

Zone	Rôle
Liste des profils	Affiche tous vos profils créés. Le profil actif est mis en évidence.
Bouton ACTIVER	Applique le profil sélectionné (remplace les fichiers, bascule l'audio, gère les symlinks).
Bouton Nouveau profil	Ouvre le dialogue de création d'un nouveau profil.
Bouton Éditer	Ouvre le profil sélectionné pour le modifier.
↺ Sauvegardes	Accès aux sauvegardes automatiques des fichiers .ini, DMD et ScreenRes, avec restauration en un clic.
Menu Préférences	Gérer les exécutables VPX, changer la langue, réinitialiser l'app.

4. Comprendre les profils

4.1 Qu'est-ce qu'un profil ?

Un profil est un instantané complet de votre configuration VPX. Il stocke :

Le contenu de VPinballX.ini
Le contenu de DMDDevice.ini
Le contenu de ScreenRes.txt
La sortie audio à activer lors du switch
L'exécutable VPX associé
Les symlinks (redirections de dossiers)
Les commandes personnalisées à exécuter

Quand vous activez un profil, le logiciel remplace les fichiers actifs sur votre disque dans cet ordre :

Sauvegarde des fichiers actuels (backup automatique horodaté)
Écriture des nouveaux fichiers .ini / DMDDevice.ini / ScreenRes.txt
Basculement de la sortie audio (si configuré)
Application des symlinks (si configurés)
Exécution des commandes personnalisées (si configurées)

4.2 Où sont stockés les profils ?

Tout est stocké localement sur votre PC. Rien n'est envoyé sur internet.

Données	Emplacement
Profils	`%APPDATA%\VPXConfigSwitcher\profiles.json`
Backups VPX .ini	`%APPDATA%\VPXConfigSwitcher\backups\`
Backups DMD	`%APPDATA%\VPXConfigSwitcher\backups_dmd\`
Backups ScreenRes	`%APPDATA%\VPXConfigSwitcher\backups_screenres\`
Exécutables VPX	`%APPDATA%\VPXConfigSwitcher\executables.json`
Langue	`%APPDATA%\VPXConfigSwitcher\language.txt`
Config PuPPacks	`%APPDATA%\VPXConfigSwitcher\puppack_settings.json`

4.3 Le système de sauvegardes automatiques

Avant chaque activation de profil, VPX Config Switcher crée automatiquement une sauvegarde horodatée de vos fichiers actuels. Les 10 dernières sauvegardes sont conservées pour chacun des trois fichiers (VPinballX.ini, DMDDevice.ini, ScreenRes.txt).

Pour accéder aux sauvegardes, cliquez sur ↺ Sauvegardes dans l'interface principale. Trois onglets s'affichent :

VPX .ini — sauvegardes de VPinballX.ini
DMD — sauvegardes de DMDDevice.ini
ScreenRes — sauvegardes de ScreenRes.txt

Pour restaurer une sauvegarde, sélectionnez-la dans la liste et cliquez sur "Restaurer".

4.4 Détection de VPX en cours d'exécution

Avant d'activer un profil, VPX Config Switcher vérifie que Visual Pinball X est bien fermé. Si VPX est encore ouvert, le logiciel affiche un avertissement et refuse d'appliquer le profil.

⚠️ Ne jamais tenter de remplacer les fichiers .ini alors que VPX est en cours d'utilisation. Cela pourrait corrompre votre configuration.

5. Créer un nouveau profil — Guide complet

Pour créer un nouveau profil, cliquez sur "Nouveau profil" dans l'interface principale. La fenêtre de création s'ouvre avec plusieurs onglets.

5.1 Onglet Général

Nom du profil

Donnez un nom court et descriptif à votre profil. Ce nom apparaîtra dans la liste principale. Exemples : "MODE 2D PINCAB", "MODE VR QUEST 3", "TEST PERFORMANCES".

Exécutable VPX associé

Choisissez dans la liste déroulante quelle version de VPX ce profil doit utiliser. Cette liste contient les exécutables que vous avez cochés lors de la configuration initiale.

📝 Si vous n'avez qu'une seule version de VPX, l'exécutable est déjà pré-sélectionné.

5.2 Onglet VPX .ini

C'est l'onglet le plus important. Il contient le contenu de VPinballX.ini qui sera appliqué lors de l'activation du profil.

Méthode 1 : Lire le .ini actuel

Cliquez sur "Lire le .ini actuel" pour importer dans le profil la configuration VPX qui est actuellement sur votre disque. C'est la méthode la plus rapide pour créer un profil basé sur votre setup existant.

Méthode 2 : Lancer VPX et capturer le résultat

C'est la méthode recommandée pour créer un profil avec des réglages que vous venez de modifier dans VPX :

Cliquez sur "Lancer VPX" dans l'onglet — cela ouvre directement Visual Pinball X.
Dans VPX, accédez aux options et ajustez vos paramètres (résolution, qualité graphique, contrôles, physique…).
Fermez VPX.
De retour dans VPX Config Switcher, le logiciel lit automatiquement le fichier .ini modifié par VPX et l'importe dans votre profil.

Éditeur .ini intégré

Une fois le .ini importé, vous pouvez l'éditer directement dans l'éditeur intégré.

⚠️ L'éditeur ne valide pas la syntaxe. Si vous modifiez manuellement le .ini, respectez le format [Section] / clé=valeur.

5.3 Onglet DMD

Cet onglet fonctionne exactement comme l'onglet VPX .ini, mais pour le fichier DMDDevice.ini. Ce fichier contrôle la configuration de votre périphérique DMD (affichage numérique de score).

Si vous n'avez pas de DMD (ou si vous n'avez pas besoin de configuration DMD différente selon les profils), vous pouvez laisser cet onglet vide. Le logiciel n'écrasera alors pas le fichier DMDDevice.ini existant lors de l'activation.

Mise à jour automatique du DMD

Une fois un profil activé et VPX ouvert, les tables peuvent modifier DMDDevice.ini (calibrations spécifiques à la table). Quand vous fermez VPX, le logiciel compare le DMDDevice.ini actuel avec celui stocké dans le profil actif. S'il détecte une différence, une popup (il faut attendre quelques secondes) vous propose :

"Mettre à jour le profil actif" — pour sauvegarder les calibrations de table dans le profil
"Ignorer" — pour ne rien modifier

5.4 Onglet ScreenRes

Cet onglet gère le fichier ScreenRes.txt, qui définit la résolution et la position des fenêtres VPX : la fenêtre de jeu (playfield), le backglass et le DMD.

En mode 2D pincab, vous avez typiquement 3 écrans avec des positions précises. En mode VR, les fenêtres sont repositionnées différemment car le rendu se fait dans le casque.

Utilisez le bouton "Lire le ScreenRes actuel" pour importer le fichier existant.

5.5 Onglet Audio

Cet onglet vous permet de définir quelle sortie audio Windows doit être activée lors de l'application de ce profil.

La liste déroulante affiche tous les périphériques de sortie audio disponibles sur votre PC, détectés en temps réel. Exemples courants :

"Haut-parleurs (Realtek Audio)" — pour un pincab classique
"Casque (Meta Quest 3)" — pour un profil VR
"HDMI (Carte graphique)" — selon votre configuration

Sélectionnez le périphérique correspondant à votre profil, ou laissez "Aucun changement" si vous ne souhaitez pas que le profil modifie la sortie audio.

📝 Le basculement audio utilise l'API Windows native (IPolicyConfig). Aucun logiciel tiers n'est nécessaire.

5.6 Onglet Symlinks

Les symlinks (liens symboliques de type Junction NTFS) permettent de rediriger un dossier vers un autre à l'activation du profil, sans déplacer ni copier de fichiers.

Cas d'usage typique : PuPVideos

Si vous avez des vidéos PuP différentes pour la 2D et la VR :

C:\vPinball\PuPVideos_2D\   ← vos vidéos pour le mode pincab 2D
C:\vPinball\PuPVideos_VR\   ← vos vidéos pour le mode VR
C:\vPinball\PuPVideos\      ← le symlink (dossier fantôme que PinUP Popper lira toujours)

À l'activation du profil 2D, PuPVideos\ est redirigé vers PuPVideos_2D\. À l'activation du profil VR, il pointe vers PuPVideos_VR\. Le switch est instantané, quelle que soit la taille du dossier.

Configuration d'un symlink

Cliquez sur "+ Ajouter un symlink"
Lien : chemin du dossier fantôme (celui que VPX / PinUP Popper lira)
Cible : chemin du vrai dossier vers lequel pointer
Répétez pour chaque dossier à gérer

📝 L'application crée des Junctions NTFS, qui ne nécessitent pas de droits administrateur ni le mode développeur Windows.

⚠️ Avant de configurer les symlinks, créez vos dossiers cibles séparément et remplissez-les avec les fichiers appropriés. Le logiciel ne copie pas vos fichiers.

5.7 Onglet Commandes personnalisées

Cet onglet permet d'exécuter des commandes Windows arbitraires automatiquement à l'activation du profil, après que tous les fichiers ont été écrits.

Exemples d'utilisation :

Type	Exemple
Script `.bat`	`C:\scripts\config_2d.bat`
Exécutable	`C:\tools\mondoutil.exe --mode 2d`
Commande reg	`reg add "HKCU\Software\MonApp" /v "MaClé" /t REG_DWORD /d 1 /f`
Commande Windows	`taskkill /f /im MonProcess.exe`

📝 Les commandes s'exécutent silencieusement en arrière-plan (pas de fenêtre CMD visible), dans l'ordre où elles apparaissent dans la liste.

5.8 Finaliser la création du profil

Une fois tous les onglets configurés, cliquez sur "Enregistrer". Le profil apparaît immédiatement dans la liste principale.

6. Gestion des PuPPacks

Un onglet "Gestionnaire de PuPPacks" est intégré au logiciel. Il vous permet en un clic de visualiser quels PuPPacks sont existants dans un dossier ou un autre, et de les copier si besoin dans le répertoire où ils sont absents. L’idée est de copier seulement les PuPPacks que vous souhaitez utiliser pour la VR pour éviter de gaspiller trop d’espace de stockage.

7. Activer un profil

7.1 Procédure d'activation

Fermez Visual Pinball X s'il est ouvert.
Dans l'interface principale, cliquez sur le profil que vous souhaitez activer.
Cliquez sur le bouton "ACTIVER".
Le logiciel effectue les opérations dans l'ordre (backup → fichiers → audio → symlinks → commandes).
Lancez VPX normalement — il démarrera avec la configuration du profil activé.

Vous pouvez aussi switcher entre les profils en faisant un clic droit sur l’icône dans la barre de notifications.

7.2 Identifier le profil actif

Le profil actuellement actif est mis en évidence visuellement dans la liste (couleur de fond différente, icône de validation).

7.3 Que faire si l'activation échoue

En cas d'erreur, le logiciel affiche un message d'erreur et tente de restaurer les fichiers depuis la dernière sauvegarde.

Causes d'échec les plus courantes :

Cause	Solution
VPX est ouvert	Fermer VPX et réessayer
Fichier `.ini` introuvable	Vérifier que l'exécutable VPX du profil est bien configuré
Droits insuffisants	Relancer VPX Config Switcher en tant qu'administrateur

8. Import et Export de profils

Exporter un profil

Les profils s'exportent au format .vpxprofile (JSON) pour les partager avec la communauté ou les sauvegarder.

Sélectionnez le profil dans la liste principale
Cliquez sur "Exporter" (ou clic droit → Exporter)
Choisissez l'emplacement de sauvegarde
Le fichier .vpxprofile est créé

Importer un profil

Cliquez sur "Importer" dans l'interface principale
Naviguez jusqu'au fichier .vpxprofile
Le profil apparaît dans votre liste
Éditez-le si nécessaire pour adapter les chemins à votre installation

⚠️ Un profil exporté contient les chemins de fichiers tels qu'ils existent sur la machine d'origine. Si votre installation VPX est dans un dossier différent, pensez à mettre à jour les chemins dans les onglets Symlinks et Commandes personnalisées.

9. Mises à jour automatiques

VPX Config Switcher vérifie automatiquement au démarrage si une nouvelle version est disponible sur GitHub Releases.

Une notification s'affiche avec le numéro de la nouvelle version et les notes de mise à jour
Cliquez sur "Télécharger et installer" pour mettre à jour automatiquement
L'application se ferme, installe la mise à jour

📝 Vos profils et paramètres ne sont jamais effacés lors d'une mise à jour. Ils sont stockés dans AppData, indépendamment de l'exe.

10. Questions fréquentes (FAQ)

Mes profils sont-ils perdus si je réinstalle le logiciel ?
Non. Les profils sont stockés dans %APPDATA%\VPXConfigSwitcher\profiles.json, indépendamment de l'exe. Vous pouvez supprimer et réinstaller le logiciel sans perdre vos profils.

Puis-je avoir plusieurs profils actifs simultanément ?
Non. Un seul profil peut être actif à la fois.

Le logiciel modifie-t-il mes tables VPX ?
Non. VPX Config Switcher ne touche que les fichiers de configuration (.ini, ScreenRes.txt). Vos tables (fichiers .vpx) ne sont jamais modifiées.

Comment sauvegarder tous mes profils ?
Copiez le fichier %APPDATA%\VPXConfigSwitcher\profiles.json dans un endroit sûr. Pour restaurer, replacez ce fichier au même endroit.

Le changement audio ne fonctionne pas
Vérifiez que :

Le périphérique audio est branché et reconnu par Windows
Il apparaît dans Paramètres → Système → Son
Vous l'avez bien sélectionné dans l'onglet Audio du profil (et non "Aucun changement")

Les symlinks ne s'appliquent pas
Vérifiez que :

Les dossiers cibles existent bien sur le disque
Le dossier "lien" n'est pas un vrai dossier existant (il doit être absent pour que la Junction soit créée)
VPX Config Switcher a les droits suffisants (essayez en administrateur si besoin)

VPX ne démarre pas après un switch de profil
Utilisez ↺ Sauvegardes pour restaurer la dernière configuration fonctionnelle.

11. Signaler un bug / Contribuer

VPX Config Switcher est un projet en phase de test. A utiliser à vos risques et périls :)

Rendez-vous sur https://github.com/Nesta78/VPXConfigSwitcher/issues
Ouvrez une nouvelle issue en décrivant le problème (étapes pour le reproduire, message d'erreur si applicable)
Rejoignez la discussion dans les issues existantes si votre problème est déjà signalé

— Fin du tutoriel —