Skip to content

v2.3.0

Choose a tag to compare

@github-actions github-actions released this 21 Aug 08:26
· 3 commits to main since this release

Mini Scraper v2.3.0

This release adds ES-DE support, safer large-library downloads, and a guided Electron desktop workflow for handheld ROM artwork.

Artwork sources

  • Automatic Libretro Thumbnails remains available with no account.
  • RetroAchievements is now the optional authenticated source.
  • Connect with a RetroAchievements username and personal Web API key from Profile → Settings → Applications.
  • Credentials are verified before the ROM-folder step and stored with Electron's encrypted credential storage.
  • RetroAchievements uses official rcheevos system-aware hashing, cached per-system game lists, box art, gameplay screenshots, and title screens.
  • When RetroAchievements has no match or selected artwork, Mini Scraper falls back to Libretro automatically.
  • The last selected artwork source is remembered between launches.

ES-DE support

  • Detects ES-DE ROM libraries and exposes ES-DE as a desktop output option.
  • Writes media to ES-DE/downloaded_media/<system>/ using ES-DE folder names.
  • Stores box art in covers, gameplay images in screenshots, and title screens in titlescreens.
  • Preserves ROM subdirectories and lets you choose a custom downloaded_media location.
  • Leaves gamelist.xml untouched; ES-DE matches artwork using the ROM filename.

Reliable large-library downloads

  • Persistent local artwork cache avoids downloading the same source image again across repeated runs.
  • Downloads run in batches of 100 by default, with a configurable pause between batches.
  • Failed requests retry automatically; HTTP 429 throttling respects the server-provided Retry-After delay.
  • The desktop progress panel reports batch pauses, throttling, retries, recovery, and failed downloads.
  • A rerun retries only missing artwork while reusing cached downloads.

Supported frontends

MinUI, NextUI, muOS, Knulli, ES-DE, TreeFrogUI, OnionOS, GarlicOS, SpruceOS, AlliumOS, Anbernic, and FunKey.

Downloads

Ready-to-run Electron ZIP archives are attached below for Linux x64, Windows x64, and macOS ARM64. Extract the archive and run Mini Scraper; a separate Node.js installation is not required.

See the README for usage, API-key setup, CLI options, and rebuilding instructions.