Wiretuts Professional unprofessional tutorials.

Installing Steven Selph's auto scraper for RetroPie

Install Stevens Selpshs auto scraper

In this tutorial we are installing Steven Selph's auto scraper for RetroPie. Scraper is tool that downloads automatically any information available for your ROMs from sites like thegamesdb. Thumbnail, rating, player count, and small snippet what kind of game is that. RetroPie has scraper by default, but it's really slow to use if you have lot of ROMs, cause you have to manually accept every finding. But gladly Steven Selph has written nice addon that does everything automatically. You have to connect keyboard to Raspberry and it has to be connected to internet.

Installing Steven Selph's auto scraper

1. Power up RetroPie and when it has started press F4 from keyboard.

RetroPie open in RaspberryPi

2. Write cd RetroPie-Setup and after that sudo ./retropie_setup.sh and hit enter.

RetroPie unix console

3. Go to Manage packages.


4. Go to Manage optional packages.

RetroPie Manage optional packages

5. Scroll to bottom until you see scraper, and select that.

RetroPie Optional packages list

6. After it has installed go back and go to Configuration / tools.

RetroPie configuration / tools menu button

7. Scroll down until you see scraper - Scraper for EmulationStation by Steven Selph and select that.

RetroPie scraper option selected

8. If you are using RetroPie with big display, you want to change max image width and height to something like 800 x 800. It takes more time to download bigger images, but it looks nicer on big display. After you have done your setup select Scrape all systems. This takes time. You want to connect your Raspberry to internet with wired connection so this process goes faster.

RetroPie Scraper options

Changing gamelist view style to detailed

9. After scraper is done, you have to change gamelist view style to detailed so you can see all the scraped data. So go to menu and select Ui settings.

RetroPie UI Settings button in main menu

10. Change your gamelist view style to detailed. Now you should see all detailed info.

RetroPie gamelist view style -setting

Deleting all scraped data from RetroPie

If you need to delete all scraped data for some reason you can do it like this.

  1. Start Raspberry.
  2. Hit F4 from keyboard when RetroPie has started.
  3. Write cd /home/pi/.emulationstation and hit enter.
  4. Write rm -rf gamelists/ and hit enter.
  5. Write rm -rf downloaded_images/ and hit enter.
  6. Now your scraped data deleted.
RetroPie unix console


Bart Coninckx - March 11, 2019
mmm, the retropie setup needs to be run by root and the scraper looks for roms in the home directory of the current user. But the roms are in /home/pi/RetroPie/roms. How to solve this?
Wiretuts - March 11, 2019
If you have problem with permissions you can use chown command to change who owns files and directories.chown -R [new-owner]:[new-group] [directory-name-or-path]
Bart Coninckx - March 11, 2019
I found the problem: I had to start the setup script as user pi with the sudo command
Wiretuts - March 11, 2019
Good to know!
Excellent step-by-step instructions! Thank you very much Jamie!
Wiretuts - October 13, 2018
No problem!