v2.4.0

v2.4.0

Ordered composite artwork

The Mini Scraper now supports explicit composite layout modes:

• Box art + screenshot
• Box art + title screen
• Screenshot + box art
• Title screen + box art

The order defines the layout: the first artwork is the large background image and the second is the smaller artwork positioned in the corner of the generated .res image.

Preview and compatibility

• Desktop preview now mirrors the generated composite layout instead of showing images side by side.
• Added reverse artwork modes to ES-DE and Knulli output handling.
• Fixed strict TypeScript issues in ES-DE and Knulli cleanup paths.
• Existing single-artwork modes remain unchanged.

All tests and cross-platform CI builds passed.

v2.3.1

2.3.1 (2026-08-24)

Bug Fixes

• discover Windows ROMs without globbing (77eb25e)

v2.3.0

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.

v2.2.0

Mini Scraper v2.2.0

This release turns Mini Scraper into a much easier desktop tool while expanding support for popular handheld CFWs and frontends.

New CFW and UI support

• Knulli — writes scraped media using EmulationStation conventions and updates gamelist.xml with boxart, screenshot and titleshot references.
• TreeFrogUI — writes artwork to its .res layout.
• GarlicOS, SpruceOS and AlliumOS — dedicated output choices using their Imgs artwork layout.
• OnionOS — now available as an explicit output choice and retains its compatible Imgs layout.

Mini Scraper also continues to support MinUI, NextUI, muOS, Anbernic stock OS and FunKey.

This version also introduces ready-to-run Electron desktop builds with automatic frontend detection and artwork previews. See the README for usage and maintainer documentation.

Downloads

Ready-to-run ZIP archives are attached below for:

• Linux x64
• Windows x64
• macOS ARM64

Extract the archive and run Mini Scraper. Packaged desktop builds include Electron and do not require a separate Node.js installation.

Artwork is sourced from Libretro Thumbnails; no account is required.

v2.1.0

2.1.0 (2026-08-21)

Bug Fixes

• ci: pin npm for desktop releases (4038775)
• ci: target fork for releases (277b203)

Features

• add multi-CFW artwork adapters (4f74685)
• add reusable scraper core (702d815)
• desktop: add guided Electron scraper (81629eb)

Reverts

• Revert "ci: use workflow token for releases" (ab4579b)