Comment utiliser HyperXMLspin

Comment utiliser HyperXMLspin

Tutoriel vidéo (Youtube)

Tutoriel texte (lisez-moi.txt)

I – hyperXMLspin : Installation rapide

1 / Lancez HyperXMLspin.exe et configurez le :
2 / Dans l’onglet <Général> Sélectionnez votre front-end Retro-FE ou HyperSpin
3 / Dans l’onglet <Général> Sélectionnez le répertoire du Front-end (Pour HyperSpin c’est là où se trouve le fichier HyperSpin.exe et pour Retro-FE c’est là ou se trouvent les dossiers Core,Collections,Meta…)
4 / Dans l’onglet <Général> Uniquement pour le Front-End HyperSpin : sélectionnez le fichier lanceur.(l’exécutable d’Hyperlaunch ou de RocketLauncher)

II – hyperXMLspin : Installation Optionnelle (HyperSpin)

Installation dans Hyperspin :
1 / Utilisez HyperHQ.exe (Utilisez l’onglet “main menu wizard”) pour ajouter un nouvel item avec comme nom celui que vous voulez , par exemple : “HyperXMLspin”
2 / A la question : “Does this menu item have a sub-wheel” cliquez “yes”. 3 / Sélectionnez la position de votre nouvel item dans la liste deja créée. (Sélectionnez ou vous voulez)
4 / Allez dans l’onglet “wheel settings” , selectionnez la wheel “HyperXMLspin” puis l’onglet “emulator”
5 / Dans le champ “Executable” : Sélectionnez le fichier HyperXMLspin.exe contenu dans le répertoire d’extraction de l’archive téléchargée.
6 / Sélectionnez Execution : Normal , PC game : Disabled , Use Full Path To Roms : Disabled , Search Subfolders : Disabled Assurez vous bien que les paramètres “Use Full Path To Roms : Disabled” & “Search Subfolders : Disabled” soient réglés sur “False” en vérifiant dans le fichier ini (“HyperSpin\Setting\HyperXMLspin.ini” pour cet exemple) Les paramètres du fichier ini correspondant doivent etre ainsi : “userompath=false” & “searchsubfolders=false” autrement les jeux ne seront pas lançables.
7 / Ne sélectionnez rien pour les champs Rom Path , Params , Extensions – WinState : Hidden
8 / Sélectionnez l’onglet “navigation/themes” , cochez “use xml indexes”,”clones use parent videos”,”clones use parent themes” puis fermez HyperHQ.
9 / Si vous avez choisi le comme nom de nouvel item “HyperXMLspin” : copiez & Fusionnez les dossiers Databases & Media dans le répertoire d’HyperSpin. Sinon modifiez tous les noms de fichier et de dossier “HyperXMLspin” par le votre avant copier & Fusionner

Configuration de base HyperXMLspin :
10/ Lancez HyperXMLspin.exe et configurez le :
11/ Dans l’onglet <Général> Sélectionnez le répertoire d’HyperSpin (là où se trouve le fichier HyperSpin.exe)
12/ Dans l’onglet <Général> Sélectionnez le fichier lanceur.(l’exécutable d’Hyperlaunch ou de RocketLauncher)
13/ Dans l’onglet <Général> Sélectionnez le nom d’item d’HyperXMLspin (Celui que vous avez créé à l’étape 1/ )
14/ Voir chapitre III pour le paramétrage avancé.

III – hyperXMLspin : Paramétrage avancé

1 / Dans l’onglet <Général> La langue d’HyperXMLspin à utiliser : français ou anglais
2 / Dans l’onglet <Général> La résolution plein écran/fenêtre : 800×600/800×600 , 1024×768/1024×768 , 1280×720/1000×720 et 1920×1080/1380×1010
3 / Dans l’onglet <Contrôles> Les raccourcis clavier pour la sortie , les paramètres et Cacher/Montrer HyperXMLspin.
4 / Dans l’onglet <Contrôles> Le clavier virtuel , si vous voulez utiliser le clavier virtuel intégré à HyperXMLspin.
5 / Dans l’onglet <Contrôles> L’émulation du joystick pour émuler le joystick en souris et permet la configuration du numéro de joystick et de 8 boutons.
6 / Dans l’onglet <Options> Le mode plein écran pour débloquer la sélection de l’image d’arrière-plan.
7 / Dans l’onglet <Options> Pour chaque vues d’HyperXMLspin selectionnez : la couleur d’arrière plan , la couleur de la police , la transparence et le style de police.
8 / Dans l’onglet <Options> Caché au démarrage pour lancer HyperXMLspin caché. (Utilisez ensuite la touche ou le bouton joystick Cacher/Montrer HyperXMLspin pour l’afficher)
9 / Dans l’onglet <Options> La prévisualisation de la vidéo pour afficher la vidéo des jeux avec le plugin activeX associé.(Windows media player,VLC qui doit être installé séparément depuis https://www.videolan.org/,ou rien)
10/ Dans l’onglet <Options> Le contrôle Parental pour définir un code PIN et bloquer l’accès au paramètres HyperXMLspin et limiter HyperXMLspin à “Montrer” et QuickSearch seulement.
11/ Dans l’onglet <Options> Le filtre parental pour filtrer les jeux pour adulte dans HyperXMLspin et également les jeux provenant des wheels exportées.
12/ Dans l’onglet <Options> Utiliser Symlinks NTFS pour utiliser des raccourcis Symlinks plutôt que de dupliquer les médias pour économiser l’espace sur le disque dur.(Uniquement possible avec des partitions NTFS)
13/ Dans l’onglet <Options> Utiliser confirmer pour quitter pour demander la confirmation avant de quitter définitivement HyperXMLspin
14/ Dans l’onglet <Options> Le thème graphique d’HyperXMLspin.(Les thèmes perso doivent être placés dans le dossier Themes à la racine d’HyperXMLspin)
15/ Dans l’onglet <Mise à jour> Vérifier médias pour vérifier les nouveaux artworks & vidéos d’Hyperspin et mettre à jour ceux d’HyperXMLspin. Permet également de partager des listes personnalisées d’HyperXMLspin.(Voir chapitre IV)
16/ Dans l’onglet <Mise à jour> Scanner filtres pour mettre à jour la liste des genres et années pour le moteur de recherche HyperXMLspin.
17/ Dans l’onglet <Mise à jour> Bouton Favoris pour mettre à jour la liste des favoris manuellement et automatiquement au démarrage d’Hyperxmlspin (La liste est générée sans filtres donc tous les favoris de tous les systèmes)

IV – hyperXMLspin : Astuces

1/ Pour les jeux trouvés ayant le même nom HyperXMLspin ajoute un espace pour les différencier les uns des autres , pour le moment cette astuce n’est compatible qu’avec HyperLaunch.
Pour RocketLauncher , éditez votre fichier HyperSpin/settings/settings.ini puis modifiez “Hyperlaunch_Path” et indiquez l’emplacement d’HyperXMLspin ( ex: Hyperlaunch_Path= F:\HyperSpin\HyperXMLspin.exe ) , n’oubliez pas de sauvegardez les modifications.
2/ Pour faire une copie de sauvegarde de votre disque dur contenant des liens symlinks créés par HyperXMLspin , utilisez un disque dur formatté en NTFS Puis utilisez en mode administrateur cmd ou powershell , utilisez la commande : xcopy /e /b /i /h Path_In Path_out ( ex: xcopy /e /b /i /h C:\HYPERSPIN f:\HyperSpin-backup )
3/ Si vous obtenez une erreur “Can’t create control” , allez dans les paramètres ,dans l’onglet <Options> selectionnez previsualisation vidéo sur” Aucun ”
Ou alors utilisez la version d’HyperXMLspin 64 bits cela corrigera le problème

V – hyperXMLspin : Fonctionnement basic

Fonctionnement HyperXMLspin (QuickSearch) :
Entrez ou cochez au moins un critère de recherche puis validez.(le bouton “Outil ne doit pas être activé)

Fonctionnement HyperXMLspin (MultiSearch) :
Entrez ou cochez au moins un critère de recherche ,sélectionnez “outils” puis :
–> utilisez la fonction “montrer” (par défaut) pour une recherche immédiate.(Les résultats peuvent être enregistrés si HyperXMLspin est en installation complète dand Hyperspin. voir chapitre II)
–> utilisez la fonction “créer” pour sauvegarder votre recherche vers une wheel principale (Hyperspin & Retro-FE) ou une wheel genre (Hyperspin).
–> utilisez la fonction “ajouter” pour ajouter les résultats de recherche à une liste déjà existante.

Les trois dernières fonctions sont utilisables sans critère de recherche :
–> utilisez la fonction “effacer” pour supprimer une liste entière HyperXMLspin et ses médias.(Utilisez HyperHQ pour supprimer une Wheel principale entièrement sauf pour RetroFE)
–> utilisez la fonction “éditer” pour l’édition d’une liste déjà existante.
–> utilisez la fonction “exporter” pour exporter une liste déjà existante vers une liste principale ou genre d’Hyperspin.(uniquement sur Hyperspin pour HyperXMLspin en installation Optionnelle. voir chapitre II)

Une fois la liste éditée , validez avec le bouton “OK”.

Astuce : pour des recherches multiples pour différents jeux : séparez chaque mots/lettre clés des jeux par une virgule.Vous pouvez sélectionner autant de critère voulu dans le ou les filtres.

VI – HyperXMLspin : Fonctionnement du partage de liste

Vous pouvez partager avec la communauté HyperSpin , Retro-FE & HyperXMLspin toutes les listes créées avec HyperXmlspin , cependant la compatibilité entre chaque utilisateur d’hyperspin ne sera pas toujours à 100 % :
Les jeux issus d’une liste ne seront compatibles qu’avec les systèmes hyperspin ayant les mêmes fichiers databases (xml) et les mêmes noms de systèmes.
Néanmoins , la fonction mise à jour des médias en mode manuel permet d’augmenter la compatibilité.
Exemple avec la liste ABestOfAll créée par ninja2bceen (contenue dans le Pack de fichiers optionnel d’HyperXMLspin dans Databases\ABestOfAll) :

Partage de liste avec HyperSpin
1 / Utilisez HyperHQ.exe (Utilisez l’onglet “main menu wizard”) pour ajouter un nouvel item avec comme nom : celui de la liste xml principale à utiliser (“ABestOfAll” pour cet exemple)
2 / A la question : “Does this menu item have a sub-wheel” cliquez “yes”.
3 / Sélectionnez la position de votre nouvel item dans la liste deja créée. (Selectionnez ou vous voulez)
4 / Allez dans l’onglet “wheel settings” , selectionnez la wheel créée (“ABestOfAll” pour cet exemple) puis l’onglet “emulator”
5 / Dans le champ “Executable” : Sélectionnez le fichier HyperXMLspin.exe contenu dans le répertoire d’extraction de l’archive téléchargée.
6 / Sélectionnez “Execution : Normal” , “PC game : Disabled” , “Use Full Path To Roms : Disabled” , “Search Subfolders : Disabled”
7 / Dans le champ “Params” : Indiquez , entre des guillemets , le répertoire d’HyperSpin (là où se trouve le fichier HyperSpin.exe – sans le \ ou / a la fin. exemple : c:\HyperSpin)
8 / Ne sélectionnez rien pour les champs Rom Path , Extensions , WinState : Hidden
9 / Sélectionnez l’onglet “navigation/themes” , cochez “use xml indexes”,”Themes only”,”clones use parent videos”,”clones use parent themes” , fermer HyperHQ Assurez vous bien que les paramètres “Use Full Path To Roms : Disabled” & “Search Subfolders : Disabled” soient réglés sur “False” en vérifiant dans le fichier ini (“HyperSpin\Setting\ABestOfAll.ini” pour cet exemple)
Les paramètres du fichier ini correspondant doivent être ainsi : “userompath=false” & “searchsubfolders=false” autrement les jeux ne seront pas lançables. L’option “Themes only” permettra de n’afficher que les jeux qui sont compatibles.(Ne cochez cette option que si vous possédez au moins 1 thème par défaut par système)
10 / Copiez la liste xml (“ABestOfAll.xml” contenue dans l’archive dans le dossier databases\ABestOfAll) dans le répertoire database créé précédemment (“/Hyperspin/databases/ABestOfAll/ABestOfAll.xml” pour cet exemple)
– Allez à l’étape 11/ –

Partage de liste avec Retro-FE
1 / Copiez la liste xml (“ABestOfAll.xml” contenue dans l’archive dans le dossier databases\ABestOfAll) dans le répertoire database de Retro-FE (“/meta/hyperlist/ABestOfAll.xml” pour cet exemple)
2 / Ouvrez le fichier Collections/main/menu.txt et ajoutez une ligne avec le nom de l’item (“ABestOfAll” sans les guillemets pour cet exemple)
– Allez à l’étape 11/ –

Mise à jour des médias dans HyperXMLspin
11 / Lancez le fichier HyperXMLspin.exe puis allez dans les paramètres.
12 / Dans l’onglet <Mise à jour> cliquez “Vérifier médias” puis Sélectionnez le mode de recherche des mises à jour : En mode auto Coché : tous les médias compatibles des jeux de la liste seront automatiquement copiés si trouvés , En mode auto Non Coché : il vous sera demandé de sélectionner manuellement les systèmes et les jeux non trouvés automatiquement avec les systèmes ou les jeux que vous possédez.
13 / Sélectionnez si besoin la ou les listes à mettre à jour (“ABestOfAll” pour cet exemple) et validez. (les listes principales sont marquées par des *** au début et à la fin de leur nom)
Donc maintenant, le répertoire media de cette liste contient tous les artworks et vidéos que vous possédiez déjà. (Vos fichiers Vidéo et artworks n’ont pas été modifiés ni supprimés mais juste copiés ou “symlinkés”)
Le fichier ABestOfAll.xml créé par ninja2bceen contient 245 jeux. Pour ma part , après un scanne auto j’en avais 130 , après un scanne manuel j’en ai eu 63 de plus…Au total : 193/245
Les résultats dépendent de votre configuration d’Hyperspin (base de données) , et donc peuvent être différents d’une personne à l’autre. Comme des listes normales , les listes partagées peuvent être éditées pour supprimer , ajouter ou trier les jeux qu’elles contiennent.

r0man0