🎨 mini-scraper

Node version

Artwork scraper for MinUI, NextUI and muOS.

[!NOTE]
MinUI does't officially support boxarts, but still has some support for it as stated by its author.

Features:

Scrapes boxart for your ROMs, in a compatible format with multiple frontends/OSes
No account needed, uses libretro thumbnails
Optionally uses local AI with Ollama for better boxart matching
No configuration needed

Intallation

Requires Node.js, and optionally Ollama for AI matching. You need to install these to be able to use the scraper. If you don't want to install these, you also have the option to use Docker.

This tool works with a Command Line Interface (CLI), and need to be installed and run from a terminal application.

Install the CLI globally by opening a terminal and running the following command:

bash
npm install -g @sinedied/mini-scraper

To run the scraper, open a terminal and use the following command:

bash
mscraper <rompath> [options]

Explanation:

<rompath>: This is the path to the directory containing your ROMs.
[options]: Replace this with the command-line arguments to be passed to the scraper.

Options

When running the scraper, you can pass the following options:

-w, --width <size>: Max width of the image (default: 300)
-h, --height <size>: Max height of the image
-t, --type <type>: Type of image to scrape (can be boxart, snap, title, box+snap, box+title) (default: boxart)
-o, --output <format>: Artwork format (can be (minui, nextui, muos, anbernic) (default: minui)
-a, --ai: Use AI for advanced matching (default: false)
-m, --ai-model <name>: Ollama model to use for AI matching (default: gemma2:2b)
-r, --regions <regions>: Preferred regions to use for AI matching (default: World,Europe,USA,Japan)
-f, --force: Force scraping over existing images
--cleanup: Removes all scraped images in target folder
--verbose: Show detailed logs
-v, --version: Show current version

[!TIP]
Max width must be adjusted depending of the device and output format, the default works well for Trimui Brick. For 640x480 devices, try with --width 200.

Example

bash
mscraper myroms --width 300 --ai

This will scrape the ROMs in the myroms folder with a max image width of 300 and using AI for advanced matching.

Running with Docker

Alternatively, you can run the scraper using Docker. This is useful if you don't want to install Node.js or Ollama on your system.

First, you need to have Docker installed on your system. You can download and install Docker from the official website.

Then, you need to clone the repository and navigate to the project directory to build the Docker image by running the following command:

bash
docker build -t mini-scraper .

Then, you can run the scraper with the following command:

bash
docker run --rm -v <rompath>:/roms mini-scraper /roms [options]

Explanation:

--rm: This removes the container after it has finished running.
-v <rompath>:/roms: This mounts your ROMs directory to the /roms directory inside the container. Replace <rompath> with the actual path to your ROMs.
mini-scraper: This is the name of the Docker image.
/roms: This is the directory inside the container where the ROMs are mounted.
[options]: Replace this with the command-line arguments to be passed to the scraper.