NanoArcade Manager

A beautiful, browser-based tool to manage your retro game collection across multiple operating systems and devices.

Try It Now

Launch Live App - Use instantly in your browser, no download required

Or download this repository for offline use.

🎮 What's New in v2.0

🖼️ Mass Auto-Scraper

The biggest art update yet. Click 🖼️ Auto-Scrape All Art in the game toolbar to automatically find and save box art for every game missing artwork in the current console.

Tries 5 URL variants per game — clean name, clean + (USA), clean + (Europe), clean + (Japan), raw filename — dramatically improving hit rate vs single-attempt searches
Falls back to directory-listing fuzzy search if direct URLs all miss
Live progress modal: each game shows ✅ found or ❌ not found in real-time
Saves to the correct OS folder structure automatically (MustardOS box/, MinUI .res/, NextUI .media/, Onion OS Imgs/, etc.)
Final summary: "X of Y games scraped"

🌍 Region Flags on Game Cards

ROM filenames are parsed for region tags and a flag emoji is displayed on every game card — 🇺🇸 🇯🇵 🇪🇺 🌍 🇰🇷 🇩🇪 🇨🇳 — giving you instant visual info without any extra clicks.

🏷️ ROM Tag Badges

Special ROM types are highlighted with colored mini-badges on each card:

🟠 BETA — beta builds
🔴 PROTO — prototypes
🔵 REV — revision releases (Rev A, Rev 1, etc.)
🟣 DISC 2/3 — multi-disc games
🟡 HACK — ROM hacks
⚫ BAD — known bad dumps

🎨 Per-Console Accent Colors

Each console system has its own color identity applied as a glow on the console icon — NES red, SNES purple, GBA indigo, Genesis blue, PS1 navy, Dreamcast orange, and more. Subtle but sharp.

🔍 Floating Zoom Bar

A sleek frosted vertical slider floats on the right edge of the screen while browsing games. Drag up for bigger cards, drag down for more cards. Default is 8 columns. Preference saves automatically.

🗂️ Sort by System in All Games View

The All Games view now has a sort dropdown: Name (A-Z), System (grouped by console with headers), and Recently Added. Sort preference is remembered between sessions.

✨ Themed Scrollbars

Custom 5px thin scrollbars throughout the app — dark track with a glowing cyan thumb that matches the overall aesthetic.

🕹️ What's New in v1.7

OS-First Approach - Instead of selecting individual devices, NanoArcade now organizes by operating system (MustardOS, Onion OS, DrUm78, MinUI, NextUI), with resolution tiers optimized for each OS's supported devices. This provides a more intuitive workflow matching how users actually configure their handhelds.

Supported Operating Systems & Devices

🥔 MustardOS (muOS)

Multi-device custom firmware with 3 resolution tiers:

Standard (324px) - 640×480 screens:

Anbernic RG28XX H
Anbernic RG35XX (original)
Anbernic RG35XX Plus
Anbernic RG35XX H
Anbernic RG35XX SP

High-Res (380px) - 720p-1024p screens:

Anbernic RG34XX
Anbernic RGCUBEXX
TrimUI Brick

Ultra (450px) - 1280×720 screens:

TrimUI Smart Pro
Anbernic RG40XX H
Anbernic RG40XX V

🧅 Onion OS

Custom firmware for Miyoo devices (250px):

Miyoo Mini
Miyoo Mini Plus
Miyoo Flip
Miyoo Mini Flip

🔑 DrUm78 (FunKey-OS)

Custom firmware for micro handhelds (240px):

Anbernic RG Nano
FunKey S
Powkiddy Q36 Mini
Powkiddy GBA Mini

⚡ MinUI

Minimalist multi-device OS with 2 resolution tiers:

Standard (200px):

Anbernic RGB30
Anbernic RG35XX series
TrimUI Smart
GKD Pixel
Miyoo Mini series

High-Res (300px):

Anbernic RG405
Anbernic RG40XX
Anbernic RG CubeXX
TrimUI Smart Pro

🚀 NextUI

MinUI fork with enhanced features and 3 resolution tiers:

Standard (200px):

Anbernic RG35XX SP

High-Res (300px):

TrimUI Brick

Ultra (500px):

TrimUI Smart Pro

Features

🕹️ Device Support

Multi-Device Selector - Switch between device profiles with different folder structures and image sizes
Onion OS Integration - Full support for Onion OS folder structure (Roms/[Console]/Imgs/)
Mustard OS Integration - Full support for Mustard OS catalogue structure (MUOS/info/catalogue/<System>/box/)
MinUI Integration - Full support for MinUI folder structure with .res folders and console tags
NextUI Integration - Full support for NextUI folder structure with .media folders
Auto-Resize - Images automatically resized to optimal dimensions per device (240px for RG Nano, 250px for Miyoo, 354px for Trimui Brick, 200px/300px for MinUI, 200px/300px/400px for NextUI)

🎨 Theme System

7 Color Themes - Choose from Blue, Purple, Green, Red, Cyan, Orange, Pink
Persistent Selection - Theme saves via localStorage

🎮 Box Art Scraping

Triple Source Search - Box art searched from Libretro Thumbnails, TheGamesDB, and GameFAQs in parallel
Libretro Thumbnails - 131 systems with thousands of box art images, cached directory listings for instant repeat searches
CORS Proxy Fallback - Automatic failover across multiple proxies for reliable scraping
Wikipedia Review Scores - Metacritic, IGN, and GameSpot scores fetched from Wikipedia (no proxy needed)
Styled Tooltips - Hover for detailed breakdowns (GameRankings, Famitsu, EGM, NintendoLife)

💾 Save Manager

Multi-Device Support - Backup, restore, and delete game saves for RG Nano, Miyoo devices (Onion OS), MinUI, and NextUI
Emulator Core Mapping - Automatic save path detection for Gambatte, gpSP, FCEUmm, Supafaust, and more
MinUI/NextUI Support - Manages saves in .userdata/[system]/Saves/ folders
Delete Confirmation - Modal confirmation prevents accidental deletions
Hidden File Filtering - Automatically ignores hidden files/folders (starting with .) except .res and .media used by MinUI/NextUI

🏆 Top 25 Must-Have Games

Curated Lists - Top 25 rated games for 16 different consoles
Collection Tracker - See which must-have games you own vs missing
Quick Upload - Drag & drop missing ROMs directly into the Top 25 modal
Supported Consoles: GB, GBC, GBA, NES, SNES, N64, Genesis, Game Gear, Master System, PS1, PC Engine, Neo Geo, Neo Geo Pocket, Atari 2600, Atari Lynx, WonderSwan

🖼️ Box Art Management

Triple Image Search - Search Libretro Thumbnails, TheGamesDB, and GameFAQs for box art
Upload Local Images - Drag & drop or browse for local artwork
URL Import - Paste image URLs directly with automatic download
Smart Processing - Auto-resize, format conversion, and optimization

📁 Organization & Filtering

Console Detection - Automatically detects and organizes games by console folder
Missing Art Filter - Quickly find games that need artwork
A-Z Sorting - Toggle alphabetical sorting
Search - Filter games by name
All Games View - Browse your entire collection across all consoles

🛠️ Game Management

Batch Upload - Upload multiple ROMs with automatic filename cleaning
Right-Click Menu - Quick actions: edit art, search, rename, delete
Google Images Integration - One-click search for hard-to-find artwork
Rename & Delete - Manage your ROM files directly

✨ User Experience

Responsive Design - Mobile-friendly hamburger menu for screens ≤1292px
Browser Detection - Friendly warning for unsupported browsers (Firefox)
Subfolder Support - Automatically scans nested ROM folders with visual indicators
Press Start 2P Font - Retro pixel font for game titles and console names
Responsive Modal - Game modal scales for smaller screens (1080p and below)
Button Hover Effects - Pop-up animation on all buttons
Styled Tooltips - Custom tooltips matching the theme
Styled Scrollbars - Scrollbars match the app theme
Loading Indicators - Visual feedback when loading large collections
Ultrawide Support - Responsive layout for any screen size
Persistent Storage - Remembers your folder selection between sessions
Modern Dark UI - Beautiful interface with smooth animations and neon accents

How to Use

Download or clone this repository
Open index.html in a modern browser (Chrome, Edge, or Chromium-based)
Select your device type from the dropdown (RG Nano, Miyoo Mini, etc.)
Click "Select ROMs Folder" and choose your device's ROM directory
Click on any console to view and manage your games
Click a game to add/edit box art, or right-click for quick actions
Click the Top 25 button to see must-have games for that console

Folder Structures

MustardOS (muOS)

MUOS/
└── info/
    └── catalogue/
        ├── gba/
        │   ├── Pokemon Emerald.gba
        │   └── box/
        │       └── Pokemon Emerald.png  (box art in box subfolder)
        ├── snes/
        └── nes/

Onion OS

Roms/
├── GBA/
│   ├── Pokemon Emerald.gba
│   └── Imgs/
│       └── Pokemon Emerald.png  (box art in Imgs subfolder)
├── SNES/
└── NES/

DrUm78 (FunKey-OS)

ROMs/
├── GBA/
│   ├── Pokemon Emerald.gba
│   ├── Pokemon Emerald.png  (box art next to ROM)
│   └── ...
├── SNES/
└── NES/

MinUI (480p / High-Res)

Roms/
├── Game Boy (GB)/
│   ├── Pokemon Red.gb
│   ├── Pokemon Blue.gb
│   └── .res/
│       ├── Pokemon Red.gb.png  (box art with ROM extension)
│       └── Pokemon Blue.gb.png
├── Super Nintendo (SFC)/
└── Nintendo Entertainment System (FC)/

NextUI (Trimui Brick/Smart Pro)

Roms/
├── Game Boy (GB)/
│   ├── Pokemon Red.gb
│   ├── Pokemon Blue.gb
│   └── .media/
│       ├── Pokemon Red.png  (box art without ROM extension)
│       └── Pokemon Blue.png
├── Super Nintendo (SFC)/
└── Nintendo Entertainment System (FC)/

Supported Consoles

The app recognizes and displays icons for:

Game Boy / Game Boy Color / Game Boy Advance
NES / SNES / N64 / GameCube
Sega Master System / Genesis / Saturn / Dreamcast / Game Gear
PlayStation / PS2 / PSP / PS Vita
PC Engine / TurboGrafx-16
Nintendo DS
Neo Geo / Neo Geo Pocket Color
Atari (2600, 7800, Lynx)
WonderSwan / WonderSwan Color
Arcade (MAME/FinalBurn)
PICO-8
And more!

Requirements

Modern web browser with File System Access API support (Chrome, Edge, Opera)
JavaScript enabled

Changelog

v2.0 - Mass Scraper, Region Flags, ROM Badges & More

Mass Auto-Scraper — New "🖼️ Auto-Scrape All Art" button batch-fetches box art for every game missing artwork in the current console. Live progress modal, per-OS folder routing, final tally summary.
Multi-URL Fallback Chain — Art scraper now tries 5 URL variants per game (clean name, +USA, +Europe, +Japan, raw filename) before falling back to fuzzy directory search. Significantly higher hit rate.
Region Flags — 🇺🇸🇯🇵🇪🇺🌍 flag emoji parsed from ROM filenames and displayed on every game card.
ROM Tag Badges — Colored pills for Beta (orange), Proto (red), Rev (blue), Disc N (purple), Hack (yellow), Bad dump (grey). Up to 2 badges per card.
Per-Console Accent Colors — Each system has a color identity (NES red, SNES purple, GBA indigo, etc.) applied as an icon glow when browsing that console.
Floating Zoom Bar — Vertical frosted slider fixed to the right edge. Drag to resize the game grid (2–12 columns). Default 8 columns, saves to localStorage.
Sort by System — All Games view now has a sort dropdown: Name, System (with grouped headers), Recently Added.
Themed Scrollbars — 5px thin scrollbars with cyan glowing thumb throughout the entire app.

v1.8.6 - Libretro Thumbnails + Wikipedia Scores + Proxy Fixes

Libretro Thumbnails Integration - New box art source with 131 systems and thousands of images from thumbnails.libretro.com. No API key required. Directory listings are cached per system for instant repeat searches.
Wikipedia Review Scores - Game info panel now shows Metacritic, IGN, and GameSpot scores from Wikipedia with native CORS support (no proxy needed). Tooltips show additional scores (GameRankings, Famitsu, EGM, NintendoLife). Replaces GameFAQs ratings which are now blocked by Cloudflare.
Smart Search Scoring - Libretro results ranked by name match quality, USA/World regions preferred, proto/beta versions deprioritized
CORS Proxy Fallback - All proxy-dependent requests now try multiple CORS proxies (corsproxy.io, codetabs.com, allorigins.win) with automatic failover
jQuery Fix - Fixed javascript:void(0) selector error in sidebar navigation
Parallel Search - Libretro and TheGamesDB searched simultaneously for faster results

v1.7 - OS-First Revolution

🌟 Operating System-Based Organization - Complete restructure from device-specific selection to OS-based workflow (MustardOS, Onion OS, DrUm78, MinUI, NextUI). This matches the real-world usage pattern where users choose firmware first, then configure for their specific device.

🥔 MustardOS (muOS) Support - Full support for MustardOS multi-device firmware with 3 resolution tiers:

Standard (324px) for 640×480 devices (RG28XX H, RG35XX series)
High-Res (380px) for 720p-1024p devices (RG34XX, RGCUBEXX, TrimUI Brick)
Ultra (450px) for 720p devices (TrimUI Smart Pro, RG40XX H/V)

🔑 DrUm78 (FunKey-OS) Support - Support for micro handheld custom firmware (240px) on RG Nano, FunKey S, Q36 Mini, and GBA Mini

🧅 Enhanced Onion OS - Comprehensive device support including Miyoo Mini, Mini Plus, Flip, and Mini Flip (250px)

⚡ MinUI Enhanced Tiers - Expanded device coverage with Standard (200px) and High-Res (300px) options

🚀 NextUI 3-Tier System - Enhanced NextUI support with Standard (200px), High-Res (300px), and Ultra (500px) resolution tiers optimized for screen resolutions

🎨 Resolution Optimization - Each OS tier uses box art sizes scientifically matched to device screen resolutions for optimal display quality

❤️ Supporter Recognition - Buy Me a Coffee integration with supporter count display

🙈 Hidden File Filtering - Automatically ignores hidden files and folders (starting with .) to prevent scanning ScummVM data and other system files, while preserving .res and .media folders needed by MinUI/NextUI

v1.6

🚀 MinUI Support - Full support for MinUI operating system with .res folder structure and console tag parsing (e.g., "Game Boy (GB)")

⚡ NextUI Support - Full support for NextUI (MinUI fork) with .media folder structure for Trimui Brick/Smart Pro/RG35XX SP

🖼️ Dual Resolution Support - MinUI devices can choose between 480p (200px) or High-Res (300px) image sizes via resolution selector modal

🎨 Smart Image Naming - MinUI images saved with ROM extension (Pokemon Red.gb.png), NextUI without (Pokemon Red.png)

💾 MinUI/NextUI Save Manager - Full save management for MinUI and NextUI devices with automatic system mapping (.userdata/[system]/Saves/) - 18 supported consoles

UI/UX Improvements:

✨ Device selector modal optimized for 1080p displays with hidden scrollbar
✨ Generic device option moved to compact button below device grid
✨ Responsive device grid (3-column on desktop, 2-column on tablets, 1-column on mobile)
✨ Device selector description moved to tooltip for cleaner layout

Bug Fixes:

🔧 Fixed MinUI/NextUI folder scanning to properly detect Roms subfolder
🔧 Fixed image rendering for MinUI/NextUI devices in game grid
🔧 Fixed image detection and loading for all device types
🔧 Added WonderSwan support to MinUI/NextUI folder mappings

v1.5

🎨 Theme Customization - Choose from 7 color themes (Blue, Purple, Green, Red, Cyan, Orange, Pink) with persistent localStorage saving

📱 Responsive Mobile Menu - Hamburger menu at ≤1292px with fullscreen overlay for phones/tablets

🌐 Browser Detection - Friendly modal for unsupported browsers (Firefox) with logos for Chrome/Edge/Opera

💾 Onion OS Save Manager - Full save management for Miyoo Mini/Mini+/Flip with emulator core mapping

📁 Recursive Subfolder Scanning - Automatically detects ROMs in nested folders with visual indicators