Guide

How to Scrape Box Art and Game Artwork on a Retro Handheld

How to Scrape Box Art and Game Artwork on a Retro Handheld guide cover image

Affiliate disclosure: This guide contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you. Learn more.

A plain list of filenames works, but a wall of box art is what makes a retro handheld feel special. Scraping is the process of automatically downloading cover art, screenshots, and game info, then matching it all to your library. Done right, it turns a folder of files into a polished, browsable collection.

This guide explains how scraping works, the two main ways to do it, and how to fix the covers that come back wrong. We frame all of this around organizing games you already own.

Affiliate disclosure: This page contains affiliate links. As an Amazon Associate and Anbernic affiliate, we earn from qualifying purchases at no extra cost to you.


What Scraping Actually Does

A scraper compares your game files against an online database, finds a match, and downloads media for it. That media usually includes a box art image, a screenshot or title screen, and text like the release year, genre, and developer. Your frontend then shows all of that when you browse.

Scraping does not change your game files. It only adds art and metadata alongside them. If a cover is wrong, you can re-scrape or fix it by hand without touching the game.

Two Ways to Scrape

There are two main approaches, and most people use one or the other depending on their firmware and patience.

On-device scraping uses the scraper built into your firmware, such as the one in EmulationStation on KNULLI, ArkOS, or ROCKNIX. It is convenient because everything happens on the handheld over WiFi. The tradeoff is that it can be slower and the art quality varies.

Computer scraping with Skraper uses a free Windows program called Skraper that runs on your PC. You point it at your game folders on the SD card, and it pulls high-quality art fast. It offers far more control over which art types you download and how they are named. For a large library, Skraper is the better tool.

Method 1: On-Device Scraping

This is the easiest path if you just want covers without using a computer.

  1. Connect your handheld to WiFi. Our firmware guides like the ArkOS setup guide and KNULLI setup guide cover this.
  2. Open the main menu in EmulationStation and find the Scraper option.
  3. Choose your source. ScreenScraper is the most common and most complete database.
  4. Pick which systems and media types to scrape, then start.
  5. Let it run. A large library can take a while, so leave it plugged in.

When it finishes, your games show covers and info. If a match is wrong, the scraper usually lets you confirm matches manually for tricky titles.

Method 2: Skraper on a Computer

Skraper gives you the best results and the most control. The basic flow looks like this.

  1. Download Skraper from its official website and install it on a Windows PC.
  2. Create a free ScreenScraper account. The scraper uses it to access the database, and an account raises your download speed limits.
  3. Insert your handheld's SD card into your computer.
  4. In Skraper, choose your frontend type, such as EmulationStation, and point it at your games folder on the card.
  5. Pick the art types you want, like box art, screenshots, and logos, and set where each one saves.
  6. Run the scrape. Skraper writes the media and a gamelist.xml file that your frontend reads.
  7. Eject the card, put it back in your handheld, and browse your freshly decorated library.

Skraper is much faster than on-device scraping for big collections, and the art quality is usually higher.

Fixing Wrong or Missing Covers

Scrapers are not perfect. Region variants, fan translations, and oddly named files can confuse them. Here is how to clean things up.

  • Rename the file clearly. A clean name like Chrono Trigger.sfc matches better than a cryptic one. Our how to organize ROMs and BIOS files guide covers good naming.
  • Re-scrape just the misses. Most scrapers let you target only games without art, so you do not redo the whole library.
  • Match manually. For stubborn titles, use the manual match option to pick the correct game from the database.
  • Add art by hand. You can drop a properly named image into the media folder yourself if the database has no match.

Tips for the Best Results

  • Scrape over a strong WiFi connection or directly on a computer for speed.
  • Box art plus a screenshot is a good combo that looks great without filling your card.
  • High-resolution art is nice, but it uses space. On a small card, stick to reasonable image sizes.
  • Back up your gamelist.xml and media folders along with your saves, so a re-flash does not erase your work.

Frontends That Show Art Well

Firmware with EmulationStation, like KNULLI, ArkOS, and ROCKNIX, displays scraped art beautifully. Minimal firmware like MinUI does not, by design. NextUI supports thumbnails on some devices. Our NextUI and MinUI setup guide explains the difference.

Recommended Handhelds

Box art looks fantastic on a sharp, larger screen. The

gives you a roomy display to show off your covers. For a premium browsing experience with vivid art, the has a gorgeous AMOLED panel.

Next, tidy up the rest of your setup with our how to organize ROMs and BIOS files and save state management guides.

Related reading