Using Scrappy to generate folder art - plaidman/cube-xx GitHub Wiki

You can use scrappy/skyscraper to generate folder art in the same way as it generates artwork for games. For this we will trick Scrappy into thinking our folders are games. You must have:

  • an unused system category that's supported by both MuOS and Skyscraper (in my examples I'm using 3do)
  • any cover/screenshot/wheel/marquee images you want to use to compose the folder artwork
  • an XML template for the layout you want to build for folders

NOTE: for any of the following steps /sdcard/ and /mmc/ folders can be used interchangably depending on which things you have migrated to SD2.

1. Create fake rom files.

If you are using 3do as your unused system category, create a 3do directory under your /ROMS directory, and populate it with empty files to match each of your system folders like so. The 3do folder name and .iso extension are important here, even though the files will be blank. Folder structure should look like this:

- /sdcard/mmc/ROMS/
   +- 3do/
       +- psx.iso
       +- snes.iso
       +- genesis.iso
       +- gba.iso

If you are not using 3do as your unused system category you can pick a different folder name and extension using the peas.json file. For the folder name, you can use the main entry label (e.g. psp on line 1870) or any of the aliases (e.g. lines 1872 or 1873). For the extension you can use any of the formats (e.g. lines 1876-1879).

2. Create component artwork.

Create a new folder 3do in /mmc/muos/application/.scrappy/static/.skyscraper/import. This folder should match whatever your fake roms are in from peas.json. Inside that folder, create a folder for screenshots, covers, or whatever else you're using in your layout. Inside these folders will be the screenshots, covers, etc for your folders. Folder structure should look like this:

- /mmc/muos/application/.scrappy/static/.skyscraper/import/
   +- 3do/
       +- covers/
           +- psx.png
           +- snes.png
           +- genesis.png
           +- gba.png
       +- screenshots/
           +- psx.png
           +- snes.png
           +- genesis.png
           +- gba.png

3. Import the files into scrappy cache.

In scrappy, go to advanced tools, then run custom import to pull all of these .png files into skyscraper's cache. This is important because the blank files you created in step 1 won't match anything in screenscraper.fr's database, but skyscraper is set to use its cache files first, so it will match those fake roms to the correct artwork.

4. Generate the artwork.

In scrappy's main menu, press select to make sure that your fake unused category is checked. You may have to rescan folders if your folder is missing. Back in the scrappy main menu, pick your desired layout, and start scraping. When scraping is finished you can take all files and folders from /sdcard/muos/info/catalogue/The 3DO Company - 3DO/box and paste them into /sdcard/muos/info/catalogue/Folder/box.

example results for CubeXX