🎮 Tutoriel simple : Configurer un launcher RetroFE

🕹️ Tutoriel simple : Configurer un launcher RetroFE

Un fichier de configuration « launcher » indique à RetroFE comment démarrer un émulateur ou une application pour un item sélectionné. Voici les étapes essentielles, expliquées en Français, avec des icônes pour rendre le tout plus sympa !

⚙️ 1. Propriétés de base

Votre fichier doit contenir au minimum :

Icône	Propriété	Description
📂	`executable`	Chemin complet (ou relatif) vers l’exécutable de l’émulateur.
🔣	`arguments`	Paramètres à passer à l’exécutable (généralement le fichier ROM).

🛠️ 2. Variables utilisables

RetroFE remplace automatiquement ces « placeholders » :

Variable	Description	Exemple de valeur
`%ITEM_FILEPATH%`	Chemin complet du fichier sélectionné	`D:/ROMs/Super Mario Bros.nes`
`%ITEM_NAME%`	Nom de l’item (sans extension)	`Super Mario Bros`
`%ITEM_DIRECTORY%`	Dossier contenant le fichier	`D:/ROMs`
`%RETROFE_PATH%`	Chemin vers le dossier racine de RetroFE	`D:/Frontends/RetroFE`
`%RETROFE_EXEC_PATH%`	Chemin complet vers RetroFE.exe	`D:/Frontends/RetroFE/RetroFE.exe`

📝 3. Exemple minimal

Imaginons que vous vouliez lancer Nestopia pour une ROM NES :


executable = D:/Emulators/Nestopia/nestopia.exe
arguments  = "%ITEM_FILEPATH%"

Si vous placez ce fichier (ex : nes.launcher.conf) dans RetroFE/launchers/, la sélection de « Super Mario Bros.nes » exécutera :
"D:/Emulators/Nestopia/nestopia.exe" "D:/ROMs/Nintendo/Super Mario Bros.nes"

🔄 4. Chemins relatifs

Pour plus de portabilité, vous pouvez utiliser un chemin relatif :


executable = ../Emulators/Nestopia/nestopia.exe
arguments  = "%ITEM_FILEPATH%"

RetroFE résoudra .. à partir de son dossier racine automatiquement.

✅ 5. Astuces & bonnes pratiques

Entourez %ITEM_FILEPATH% de guillemets si le nom contient des espaces.
Testez vos chemins dans un terminal Windows (cmd.exe) avant de lancer RetroFE.
Maintenez un fichier de launcher par plateforme ou par émulateur pour rester organisé.