# Scrape & Metadonnées

Le scrape permet de récupérer les informations et les médias des jeux de votre bibliothèque (images, vidéos, cartes, fichiers pad2key et manuels).

4 bases de données peuvent être scrapées:

* ScreenScraper (par défaut) : inscription requise sur le site web [screenscraper](https://www.screenscraper.fr/)
* [TheGamesDB](https://thegamesdb.net/)
* [HFSDB](https://db.hfsplay.fr/)
* ArcadeDB
* [IGDB](https://www.igdb.com/) : Nécessite de renseigner manuellement le clientid IGDB ainsi que le secret depuis le menu scrapeur de RetroBat (voir la méthode sur la page de l'api [IGDB](https://api-docs.igdb.com/#getting-started))

### **Informations scrapées**

* Informations générales du jeu (titre, année de parution, nombre de joueurs, description...)
* Note
* Vignette (boîtier)
* Logo / bannière
* Vidéo
* Fanart
* Image (écran titre ou capture en jeu)
* Dos du boîtier
* Carte
* Manuel utilisateur
* Fichier pad2key

### Comment scraper ?

Le scrape peut être effectué globalement (pour tous les systèmes) ou pour un seul jeu.

#### Scrape global

Aller à la [section dédiée du wiki](https://wiki.retrobat.org/francais/premiers-pas/adding-a-game#scrape-global).

#### Scrape individuel

Aller à la [section dédiée du wiki](https://wiki.retrobat.org/francais/premiers-pas/adding-a-game#scrape-individuel-par-jeu).

### Options de scrape

Les options de scrape sont accessibles dans le [**MENU PRINCIPAL**](https://wiki.retrobat.org/francais/main-menu#parametres-des-jeux) en sélectionnant **SCRAPEUR :**

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FiVYbWJRMUFzMvWjU6y2l%2F2026-03-15_12h15_43.png?alt=media&#x26;token=20a01957-06e8-4bc5-af94-46c8904df3e6" alt=""><figcaption></figcaption></figure></div>

Avant de démarrer le scrape, il est possible de:

* choisir la base de données à scraper
* ne scraper que les jeux ayant des médias manquants
* ignorer les jeux scrapés récemment
* limiter les systèmes à scraper
* inclure / exclure des scrapeurs

Chaque scrapeur possède également des réglages qui lui sont propre:

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F1ZVIpwjDx3OzMttKb4SF%2F2026-03-15_12h17_07.png?alt=media&#x26;token=74e3a016-5547-4081-a0fb-755117dd5c7d" alt=""><figcaption><p>Exemple de réglages disponibles pour ScreenScraper</p></figcaption></figure></div>

Il est notamment possible de définir:

* le type de média à télécharger en tant que fichier "image" (image titre, capture en jeu...)
* le type d'image à utiliser pour représenter le boîtier (2D, 3D, etc.)
* le type d'image à utiliser comme logo (logo, bannière)

{% hint style="info" %}
Les paramètres de connexion au service Screenscraper doivent être renseigné dans les options du scrapeur.
{% endhint %}

### Comptes de scrapeurs

Screenscraper et IGDB nécessitent la création d'un compte, les informations requise doivent être renseignées dans l'onglet "COMPTES" :

<figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FB2OudKRIDqjtk8sjXPlz%2F2026-03-15_12h24_33.png?alt=media&#x26;token=ecb55bf1-ca76-428e-ae99-425d631bd573" alt=""><figcaption></figcaption></figure>

### Désactivation des services de scrape

Au bas de l'onglet "OPTIONS", il est possible de sélectionner les scrapeurs a utiliser :

<figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fd1u7wtMQeNqBoVzqemrm%2F2026-03-15_12h28_04.png?alt=media&#x26;token=a1080224-2916-4e68-a88a-ac258dc20723" alt=""><figcaption></figcaption></figure>

### Stockage des médias téléchargés

Tous les médias téléchargés sont stockés dans le dossier des jeux (répertoire `\roms`)

<div align="left"><figure><img src="https://i.imgur.com/XlUVX8L.png" alt=""><figcaption><p>Exemple</p></figcaption></figure></div>

<table><thead><tr><th width="199">Répertoire</th><th>Média stocké</th></tr></thead><tbody><tr><td>images</td><td>boîtier (thumb), fanart, dos du boîtier (boxback), image, logo (marquee), carte (map)</td></tr><tr><td>manuals</td><td>Manuel utilisateur</td></tr><tr><td>videos</td><td>Vidéo mp4</td></tr></tbody></table>

### Utiliser des médias locaux

Il est également possible d'utiliser des images et vidéos déjà disponible sur votre ordinateur, ou que vous auriez crées vous-même.\
\
Pour cela, il faudra :

* Renommer les médias exactement comme le jeu,
* Rajouter l'extension de fichier correspondant au type de média :
  * *nom\_du\_jeu***-thumb** pour un visuel correspondant au boitier
  * *nom\_du\_jeu***-image** pour un visuel correspondant à une image du jeu
  * *nom\_du\_jeu***-marquee** pour un visuel correspondant au logo du jeu
  * *nom\_du\_jeu***-video.mp4** pour une vidéo.
* Placer les médias dans un répertoire nommé "**images**" pour les images, et "**videos**" pour des vidéos
* Depuis les [**PARAMÈTRES SYSTÈMES**](https://wiki.retrobat.org/francais/main-menu#parametres-systeme), dans  "**options développeur**", activer l'option "**Rechercher des visuels complémentaires**"

<figure><img src="https://i.imgur.com/pTTYZa0.png" alt=""><figcaption></figcaption></figure>

### Gestion des métadonnées du jeu

Le menu [Options du Jeu](https://wiki.retrobat.org/francais/navigation/game-options) permet également de modifier manuellement les métadonnées des jeux:

<div align="left"><figure><img src="https://i.imgur.com/PfePfik.png" alt=""><figcaption></figcaption></figure></div>

**Il est possible de :**

* Mettre à jour les informations générales (titre, description, note, date de sortie, développeur, éditeur, famille de jeu, genres, système d'arcade, nombre de joueurs, langue et région)
* Modifier les médias (attacher d'autres images)
* Ajouter le jeu aux favoris
* Masquer le jeu
* Etiquetter le jeu "enfant" afin de le faire apparaître dans l'[interface Enfant](https://wiki.retrobat.org/francais/utilisation-avancee/kiosk-and-kid-mode#mode-enfant)