skyscraper
3.7.7
Un grattoir de jeu puissant et polyvalent mais facile à utiliser écrit en C ++ pour une utilisation avec plusieurs frondendes fonctionnant sur un système Linux (macOS et Windows également, mais pas officiellement pris en charge). Il gratte et cache diverses ressources de jeu provenant de diverses sources de grattage, y compris des médias tels que la capture d'écran, la couverture et la vidéo. Il vous donne ensuite la possibilité de générer une liste de jeux et des illustrations pour le frontend choisi en combinant toutes les ressources en cache.
Toutes les fonctionnalités de gratte-ciel sont bien documentées et il y a aussi une FAQ si vous avez toujours des questions après la lecture de la documentation, veuillez envisager de les demander sur le Subdredit RetroPie ou dans les forums officiels de Retroppie. La page Issues ici sur GitHub est destinée aux rapports de bogues et aux demandes de fonctionnalités uniquement. Merci!
Consultez la liste complète des plateformes ici.
Le gratte-ciel prend en charge une variété de sources de grattage différentes appelées modules de grattage . Utilisez-les pour collecter des données de jeu dans le cache de ressources de gratte-ciel. Consultez la liste complète des modules de grattage ici et en savoir plus sur le cache de ressources ici.
Les demandes de traction ne sont pas actuellement acceptées car je me concentre sur d'autres projets. Si vous recherchez une fourche plus axée sur la communauté qui cherche à étendre l'ensemble de fonctionnalités actuel au-delà de ce que j'ai implémenté ici, vous devriez consulter cette fourche.
Suivez les étapes ci-dessous pour installer la dernière version du gratte-ciel. Les lignes commençant par $ signifient une commande dont vous avez besoin d'exécuter dans un terminal sur la machine sur laquelle vous souhaitez l'installer.
NOTE! Si vous utilisez la distribution RetroPie, vous avez la possibilité d'installer un gratte-ciel directement à partir du script RetroPie-Settup ( vous devez mettre à jour le script avant de l'installer! ). En savoir plus sur tout cela ici. Sinon, lisez la suite.
Le gratte-ciel a besoin de QT5.3 ou ultérieure pour compiler. Pour une rétrope, Ubuntu ou une autre distribution dérivée de Debian, vous pouvez installer QT5 en utilisant les commandes suivantes:
$ sudo apt update
$ sudo apt install build-essential qt5-default
On pourrait vous demander votre mot de passe sudo. Sur Retropos, le mot de passe par défaut est raspberry . Pour installer QT5 sur d'autres distributions Linux, veuillez vous référer à leur documentation.
NOTE! Depuis Ubuntu 21.04 et transférer le métapackage qt5-default n'existe plus. Vous devrez plutôt faire sudo apt install build-essential qtbase5-dev qt5-qmake qtbase5-dev-tools qui installe la même chose que la commande ci-dessus.
Le gratte-ciel fonctionne également parfaitement sur macOS, mais n'est pas officiellement soutenu car je ne possède pas de Mac. Mais avec l'aide de HoraceandthSesider et Abrinthebay, voici les commandes nécessaires pour installer le QT5 et d'autres conditions préalables:
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew install gnu-tar --with-default-names
$ brew install wget
$ brew install qt5
$ brew link qt5 --force
Si cela s'est bien passé, passez aux instructions d'installation par défaut ci-dessous. Cela devrait fonctionner et vous donner une installation de travail de gratte-ciel.
Remarque 1! L'utilisateur «Davidmgrantham» rapporte que les --with-default-names ci-dessus pourraient être obsolètes pour certaines installations macOS. Si vous le supprimez, vous devez également télécharger la update_skyscraper.sh et modifier les commandes tar pour être gtar avant de l'exécuter.
Remarque 2! L'utilisateur «TRVRPLK» rapporte de nombreux problèmes sur MacOS 11.2+. Vérifiez ici les correctifs potentiels.
Lorsque vous avez installé les conditions préalables comme décrit ci-dessus, vous pouvez installer un gratte-ciel en tapant les commandes suivantes:
$ cd
$ mkdir skysource
$ cd skysource
$ wget -q -O - https://raw.githubusercontent.com/muldjord/skyscraper/master/update_skyscraper.sh | bash
La dernière commande téléchargera et exécutera le dernier script de mise à jour de GitHub. Au cours de l'installation, on pourrait vous demander votre mot de passe sudo. Sur Retropos, le mot de passe par défaut est raspberry .
Une fois le script terminé, vous êtes prêt à exécuter un gratte-ciel!
Depuis le gratte-ciel 2.3.2 et plus récent, vous pouvez mettre à jour vers la dernière version simplement en exécutant les commandes suivantes:
$ cd
$ cd skysource
$ ./update_skyscraper.sh
On pourrait vous demander votre mot de passe sudo pendant la mise à jour. Sur Retropos, le mot de passe par défaut est raspberry . Si votre version est plus âgée de 2.3.2 (vérifier avec --help ), vous devez plutôt suivre les instructions d'installation.
Si vous avez installé un gratte-ciel en utilisant les instructions de ce lecture, vous pouvez le désinstaller en utilisant les commandes suivantes:
$ cd
$ cd skysource
$ sudo make uninstall
$ cd
$ rm -Rf skysource
$ rm -Rf .skyscraper
On pourrait vous demander votre mot de passe sudo pendant les processus. Sur Retropos, le mot de passe par défaut est raspberry .
Windows n'est pas officiellement pris en charge pour le moment! Mais je compile et je lève une version Windows 64 bits non étayée qui fonctionne très bien. Assurez-vous de lire la lecture incluse du fichier téléchargé avant de l'utiliser! Et juste pour être clair: vous êtes seul si vous utilisez cette version - ne me posez pas de questions à ce sujet. Obtenez la version Windows ici.
IMPORTANT!!! Pour que le gratte-ciel fonctionne correctement, il est nécessaire de quitter votre frontend avant de l'exécuter! Si vous exécutez EMUMSTAT, vous pouvez le quitter en appuyant sur F4.
N'oubliez pas que vous pouvez personnaliser complètement les exportations de gratte-ciel d'art. Consultez la documentation ici. Si vous souhaitez simplement utiliser le gratte-ciel par défaut (assez cool) fournit, lisez la suite.
Pour les nouveaux utilisateurs, je recommande de lire le cas d'utilisation court et vers le point. Veuillez le lire et revenir ici lorsque vous en avez obtenu l'essentiel.
Le gratte-ciel est un outil de ligne de commande et a de nombreuses options pour vous pour vous jouer. Je recommande de les jeter à tous pour vous familiariser avec les possibilites:
$ Skyscraper --help
$ Skyscraper --flags help
$ Skyscraper --cache help
Cela vous donnera une description de tout ce que le gratte-ciel peut faire si vous vous sentez aventureux! Pour une description approfondie de toutes les options disponibles, vérifiez ici.
Les plus importants sont probablement:
-p <PLATFORM>-s <SCRAPING MODULE>-u <USER:PASS> ou -u <KEY>--cache refresh--flags videos Si vous avez vos ROM dans un emplacement sans défaut (par défaut pour les utilisateurs de RetroPie est /home/<USER>/RetroPie/roms/<PLATFORM> ) ou si vous souhaitez exporter la liste de jeux ou les illustrations vers des emplacements sans défaut, vous allez également Besoin de ceux-ci:
-i <PATH>-g <PATH>-o <PATH> Pour presque toutes les options de ligne de commande, envisagez de les définir dans le fichier /home/USER/.skyscraper/config.ini comme décrit ici. Cela rendra les options permanentes afin que vous n'ayez pas besoin de les taper tout le temps.
Skyscraper propose plusieurs façons de collecter des données pour un sous-ensemble de ROM. Si vous voulez simplement gratter les ROM qui n'ont aucune donnée dans le cache, vous pouvez le faire avec l'option de ligne de commande --onlymissing . Vous pouvez également consulter les options de nom de fichier --startat FILENAME et --endat FILENAME . Si vous souhaitez simplement recueillir des données pour quelques ROM Skyscraper -p amiga -s openretro "/path/to/rom name 1.lha" "/path/to/rom name 2.lha" vous pouvez simplement ajouter le (s) nom (s) de fichier à la fin de la ligne de commande (par exemple. Skyscraper -p amiga -s openretro "/path/to/rom name 1.lha" "/path/to/rom name 2.lha" ). Et probablement le moyen le plus avancé (et tout à fait pratique) de recueillir des données pour un sous-ensemble de ROM est d'utiliser l'option --cache report:missing=RESOURCE . Cela peut générer un rapport contenant les noms de fichiers qui manquent une certaine ressource. Vous pouvez ensuite renvoyer le rapport dans le gratte-ciel avec le --fromfile REPORTFILE par la suite. Le gratte-ciel ne fera alors que gratter les fichiers contenus dans le rapport.
Une fonctionnalité moins connue, mais extrêmement utile, du gratte-ciel consiste à ajouter les variables de configuration souhaitées à /home/USER/.skyscraper/config.ini . Toutes les options définies dans ce fichier seront utilisées par défaut par gratte-ciel. Donc, si vous utilisez toujours, par exemple, -i <SOME FOLDER> sur la ligne de commande, vous pouvez définir l'option correspondante inputFolder="<SOME FOLDER>" dans la configuration.
Pour une description complète de toutes les options de configuration disponibles, vérifiez ici.
L'une des fonctionnalités les plus puissantes du gratte-ciel est le cache de ressources. Il est important de comprendre comment cela fonctionne afin d'utiliser le gratte-ciel à son plein potentiel. En savoir plus ici.
J'ajoute à permettre le grattage des ressources en cache localement, le gratte-ciel vous permet également d'importer vos propres données dans le cache de ressources avec le module de grattage -s import . Vous pouvez également modifier les ressources existantes dans le cache ou ajouter des ressources user individuelles avec la commande --cache edit . Enfin, vous avez également la possibilité d'importer des données existantes sur la liste des jeux d'émulation EMUMSTAT dans le cache de ressources de gratte-ciel si vous en avez besoin. Vous pouvez le faire avec le module de grattage -s esgamelist .
Pour en savoir plus sur l'une des fonctionnalités décrites ci-dessus, veuillez consulter toute la documentation ici.
Consultez la documentation complète des illustrations ici
--flags unpack qui a rompu avec 3,6.8 en raison des appels de fonction QT obsolètesDes notes de libération pour les versions plus anciennes peuvent être trouvées ici.
