Home Interests RetroPie

RetroPie scrapers: what they are and how to use them

Wait, which game is this?
howchoo   (467)
September 29, 2023
8 minutes


You'll Need 1

What you'll need
Howchoo is reader-supported. As an Amazon Associate, we may earn a small affiliate commission at no cost to you when you buy through our links.
Posted in these interests:
pi • 92 guides
retrogaming • 29 guides
retropie • 17 guides

You’ve put so much work into setting up RetroPie or EmulationStation. You load it up with legally obtained ROMs only to find that custom theme you installed—you remember, the one from my RetroPie themes guide—has a big blank spot for box art!

The Best RetroPie Themes (And How to Install Them)
You deserve some personal flair!

build your own raspberry pi retro gaming rig

RetroPie: Build Your Own Raspberry Pi Retro Gaming Rig
How to install (and use) RetroPie!

How can we fill in this information for all of those ROMs?

That’s where a process known as scraping comes in. To tackle this problem, you’ll need something referred to as a scraper.

1 – What is scraping?

While playing games may be the ultimate goal of running RetroPie or Emulation Station, there’s still something to be said about a well made user interface. When you select your ROMs, seeing the box art and game information adds a clean, professional touch.

The additional box art and info is referred to as metadata. The process of putting this metadata onto your Pi is called scraping. In this guide, we’ll take a closer look at a scraper and how to use it to put metadata on your RetroPie.

2 – How it works

Scraping pulls metadata for your ROMS from the internet and integrates it with your list automatically. As long as you have a connection to the database, updating your collection is as easy as pressing a button.

One of the easiest scrapers to use with RetroPie is already built in to the system. The RetroPie scraper can be accessed from the main menu under the option labeled “Scraper”.

3 – How to use the built in Scraper

By default, the ROMs will be synchronized with metadata from TheGamesDB.net. To synchronize your ROM list, choose “Scrape Now”. There are several options you can adjust throughout the syncing process. For example, you can synchronize specific systems or choose to include ratings.

The amount of time this process takes depends on several factors including your list of ROMs, its size, your internet connection speed, and abstract forces in the universe that occasionally act at random against electronics when you want to do something fun.

If it seems to take a while, leave your Pi overnight to finish synchronizing the information.

4 – Third party scrapers

Some users prefer to use third party scrapers to pull their information. These scrapers need to be manually installed. Here are a few common scrapers with installation instructions.

Sselph’s Scraper

[Official Installation Instructions] – Steven Selph’s Scraper is an easy to use third party scraper. It’s not hard to setup and can be a fast way to scrape metadata to your RetroPie.


[Official Installation Instructions] – Skyscraper is a highly customizable option with an interesting level of depth in the kind of information it scrapes. It was created by Lars Muldjord. This scraper is one the most versatile and regularly maintained scrapers available for the RetroPie.

5 – Troubleshooting common scraper issues

Slow Synchronization Time

If you’re using the default scraper, this is a commonly heard of side effect. The database has been known to experience intermittent downtime. However, you may want to investigate additional factors that may be affecting your internet connection speed.

No Database Connection

The first thing you need to check is your internet connection. Verify your Raspberry Pi is connected to your network. Ensure the Pi is able to reach the internet. If it can’t, make sure other devices on the network aren’t having a similar problem.

If you’re using the default scraper, you may just need to try again later.

Low Res Artwork

The database you pull metadata from is responsible for the quality of artwork. If you’re not happy with the results, you may want to experiment with a different scraper.


How to Run a Minecraft Server on the Raspberry Pi

A whole world trapped inside your Pi.
howchoo   (467)
December 7, 2023

There are several ways to go about running a Minecraft server on the Raspberry Pi. In this guide, I’ll cover how to install Nukkit—a cross-platform Minecraft server that’s super easy to set up on the Raspberry Pi. This server should work with PCs, consoles, and tablets running Minecraft 1.14. I’ll be using a Raspberry Pi

Continue Reading


 467 guides

Introducing Howchoo, an enigmatic author whose unique pen name reflects their boundless curiosity and limitless creativity. Mysterious and multifaceted, Howchoo has emerged as a captivating storyteller, leaving readers mesmerized by the uncharted realms they craft with their words. With an insatiable appetite for knowledge and a love for exploration, Howchoo's writing transcends conventional genres, blurring the lines between fantasy, science fiction, and the surreal. Their narratives are a kaleidoscope of ideas, weaving together intricate plots, unforgettable characters, and thought-provoking themes that challenge the boundaries of imagination.

Discover interesting things!

Explore Howchoo's most popular interests.