ScrapMu

A box art and metadata scraper for MustardOS Andromeda on the Anbernic RG35XX family (all Allwinner H700 — Pro, Plus, H, SP, 2024). Built with LÖVE2D on the shared fskit kit.

Download ScrapMu-0.2.0.muxapp View Source on GitHub


Why ScrapMu?

Existing tools fell short when used alone:

  • Scrappy loses the preview image whenever a template is used (because templates like Retro Dither Style.xml declare only <output type="cover">), and text is limited to description + genre.
  • Artie provides detailed text metadata (synopsis, genre, developer, publisher, release date, players), but lacks a compositor for template box art.

ScrapMu combines the best of both: it queries ScreenScraper once per ROM to populate its local cache, generates the template box art offline, and extracts both the screenshot preview and the full Artie-style metadata text block from that same single query.


Features

  • Quota Conservation: Only 1 API query per ROM saves daily ScreenScraper quota.
  • Template Compositing: Full support for Skyscraper artwork.xml templates, including Retro Dither Style.
  • Rich Text Metadata: Formats complete game descriptions, developer, publisher, year, and rating into the MustardOS catalogue.
  • Single ROM & Batch Modes: Scrape full collections automatically or curate individual games with manual lookup refinement.
  • Embedded Web Dashboard: Run ScrapMu with an embedded HTTP server to monitor and initiate scrapes via Wi-Fi from your computer or phone.

Gamepad Controls

Home Screen

Button Action
D-pad Left/Right Cycle template (Retro Dither, etc.)
A Start scraping selected systems
X Open Single ROM two-column scraper
SELECT Open scraping & account settings
B Quit to MustardOS

Single ROM Screen

Button Action
D-pad Up/Down Navigate ROM list
A Scrape artwork & metadata for highlighted ROM
X Download manual to ROMS/Game Manuals/
Y Toggle filter: show missing artwork only
SELECT Open settings
B Return to main screen

Output Structure

ScrapMu populates the standard MustardOS catalogue folders:

MUOS/info/catalogue/<system>/
├── box/         # Template-rendered 3D/2D cover art (e.g. Retro Dither)
├── preview/     # Cached screenshot preview
└── text/        # Artie-format metadata: synopsis, genre, rating & release year

Installation

  1. Download the latest .muxapp from ScrapMu Releases.
  2. Copy it to ARCHIVE/ on your SD card.
  3. On the device: Applications → Archive Manager, select the file.
  4. Launch from Applications → ScrapMu.

This site uses Just the Docs, a documentation theme for Jekyll.