Scrappy - art scraper powered by Skyscraper

Scrappy is an art scraper for muOS, with the standout feature of incorporating a fully-fledged Skyscraper app under the hood. This integration enables near-complete support for artwork XML layouts, allowing Scrappy to scrape, cache assets, and generate artwork using XML mixes with ease.

Please read our Wiki for more information!

:sparkles: Features

  • Skyscraper backend (artwork XML, cached data, and many other features)
  • Auto-detection of storage preferences
  • Auto-detection of ROM folders (based on muOS core assignments)
  • Configurable app options
  • Simple UI & navigation
  • Support for user-created artworks (easily drop your XML in templates/)
  • Support for box, preview and splash outputs
  • OTA updates

:package: Installation

To install Scrappy, follow these steps:

  1. Download the latest release (not the update package - that’s for OTA!).
  2. Move the downloaded file to the /mnt/mmc/MUOS/ARCHIVE folder.
  3. Open Archive Manager and select the file.
  4. After extraction, you’ll find an entry called “Scrappy” in the Applications section.

When you run Scrappy for the first time, it will create two configuration files: skyscraper_config.ini and config.ini.

These files, and the rest of the Scrappy content, will be located at /mnt/mmc/MUOS/application/Scrappy/.scrappy
Important steps after installation

:framed_picture: Community templates

We now have a repository of community templates! Share your XMLs for artwork generation and browse them in a simple way.
Scrappy Community

:sparkling_heart: Support my work

If you like my work and find this project useful, please leave a star on Github.
And if you want to support my work even further, feel free to donate!

7 Likes

I have a few systems that Scrappy says its finding art for (using the built in scraping) but the art isnt showing in the system folders after doing so.

The scraper is showing me the boxart in the preview window, but when I go to my games folders for those systems, no boxart shows up. I have around 20 different systems/folders and its only an issue with three of them. The NEC SuperGrafx, Nintendo FDS (famicom disk system) and the SuFami Turbo (a SNES addon made by Bandai).

I thought maybe the issue at least with the SuperGrafx was the omission of the .sgx filetype from the peas.json file, but even after adding it, still getting blank box art in the folders.

I also edited config.ini to make sure those systems showed up as “choices” and input their system names to match their names as per this list: Platform assignment and file types · gabrielfvale/scrappy Wiki · GitHub

However, still I only get the image previews and not showing up in the games folders.

Also, unrelated - after importing custom images, can the source picture files (.png, .jpg, etc) be deleted from the import directory or do they need to remain?

Great work on Scrappy, it’s a must on my handhelds.

Can the credentials path be set to SD2 (for it to persist if SD1 needs a reflash)?

I’m having an issue with scraping SG-1000 games.

Scrappy identifies and scrapes the games.

(I had to change a parameter in config.ini from “sg1000” to “sg-1000” to get this to actually happen, but it worked)

Thumbnails show up in the preview as it scrapes.

But after scraping finishes, the images are nowhere to be found anywhere on the SD card.

I haven’t had this issue with any other platforms.


A different issue I’m having with Mega Duck games, it just gives an error that Skyscraper failed. Let me know if Mega Duck just can’t be scraped.

I figured out the issue for Famicom Disk System and SuFami Turbo was because I didn’t have default cores selected which I realized was needed after reviewing Artwork | muOS so this was a muOS issue (and a user issue-me lol) ultimately.

The issue for SuperGrafx, however, as best as I can tell, is maybe because Scrappy’s peas.json file lists SuperGrafx as an alias for PC Engine and PC Engine CD. I realized the art was getting scraped into my PC Engine in MUOS/info/catalog meanwhile muOS has a dedicated catalog folder for SuperGrafx so after just moving those png files into the SuperGrafx folder they showed up.

Anywho, thanks for the great app! Maybe update peas.json so SuperGrafx is treated as its own system would save that last remaining non user related issue I had

1 Like

SG-1000 art is being saved in the master system folder. I don’t know if it has to do with Scrappy or how Skyscraper interprets those games. For the moment you can move their art from the /catalogue/master system folder to the sg-1000 folder or just set the genesis plus gx core, the default for sg-1000, but using master system as the system, then the art will show. You guys can check the logs in the scrappy folder to see where art is being saved and what is happening. Probably other games where scrapping is happening but no art is showing are just being saved to a different location than expected too. The logs are really helpful, check and share them when issues are found.

And about art not appearing to a folder without a set system/core, I don’t see how it is a muOS issue. muOS binds artwork by system, so without one set, no art will be shown. If you think the naming convention you use for those systems should be auto assigned by muOS, you can post in Ideas for them to be considered and most probably included in the auto assign list.

It isn’t in the Master System folder, all that’s in the folder are Master System games.

I even did a full search of the SD card for the titles of a few of my SG-1000 ROMs and nothing at all came up.

I took a look at the logs like you suggested and found something noteworthy. Every game that was scraped says

“Catalogue destination folder not found”

I’ve opened up an issue on Github so you can track the progress and gather evidence.
For now, can you check which platform your SG-1000 folder is mapped to in config.ini?

I have another question. I downloaded the Dolphin core, and I got scrappy to actually scrape gamecube box art, and it the cache data will make its way to the scrappy_cache folder - but from there it doesnt covert to an image file over to the muOS nintendo gamecube catalogue folder (or any system catalog folder). Not sure if there is something I can tweak to make it work. Not sure if its even possible given this is an added core and not a part of a stock muos install?

It was mapped to “sg1000” and Scrappy gave me an error that it was an invalid platform, so I renamed it to “sg-1000” and it worked.

I’m not finding SG-1000 art in my Master System folder. It doesn’t seem to land anywhere.

I also wanted to add something I have been able to replicate with every single custom import I have done. If you do a custom import and do “scrape single rom” for those games, it will ignore your import and just scrape from screenscraper. In order for it to detect your custom import you have to do the full scrape scan.

Currently Gamecube is not oficially supported on Scrappy, so there is no catalogue mapping. If you feel comfortable doing so, you could manually edit the code, by adding the platform and its corresponding catalogue folder in helpers/muos.lua. Add an entry in the platforms table with the format ["<platform>"] = "<catalogue folder>"

This will be addressed in a future update. Overwriting existing resources when using single scrape was a requested feature, but I’ll add the option on-screen as that makes a lot of sense.

1 Like