Releases: TheGammaSqueeze/GammaOS-BoxartTool
Release list
v1.4.0
GammaOS Boxart Tool v1.4.0
- Scrape full metadata (description, genre, players, rating, release date, developer, publisher) from ScreenScraper and TheGamesDB, matching Nano's on-device scraper, so the in-game Information page is complete instead of image-only.
- Edit the title of any game, even after scraping (GUI button and the
titlecommand). - No more restart on every change: Nano reloads your changes in place on builds that support it, and the tool falls back to a full restart on older builds. The restart path now targets whichever Nano service is running.
- The game list shows each game's on-device path.
Download the binary for your system below. Run with no arguments for the GUI, or pass a command for the CLI. You still need adb on your PATH.
v1.3.2 - preview, apply and refresh fixes
GammaOS Boxart Tool v1.3.2
Fixes and polish from user feedback.
- Full-size previews in Search & Choose. The chosen result now shows the complete cover and the complete background in fixed preview boxes (they were clipped on Windows), so you can see exactly what you are applying.
- Applying art just works. Apply Cover / Background / Both now runs off the UI thread and the list updates on its own, so the app no longer looks frozen and you do not have to refresh manually to see the new art.
- Restart Nano and every other device action are non-blocking now, with clear status, instead of leaving a spinning cursor.
- Game paths in the list. The list has a new Path column (with horizontal scroll), and you can filter by path as well as name and system.
Download the binary for your system below.
v1.3.1 - scrape progress and result summary
GammaOS Boxart Tool v1.3.1
Better feedback while scraping.
- Scrape Selected and Scrape Library now show a progress dialog (a progress bar, the current game, and a running tally), so the app never looks like it hung.
- When it finishes you get a clear result summary with metrics: covers and backgrounds applied, plus skipped, no-match and error counts, and a heading that tells you at a glance whether it was successful, mixed, or failed.
- Bulk scrapes can now be cancelled mid-run.
No changes to matching or sources. Download the binary for your system below.
v1.3.0 - TheGamesDB, search and multi-select
GammaOS Boxart Tool v1.3.0
The scraper is now multi-source, searchable, and multi-select.
- Two sources. Choose ScreenScraper (GammaOS's developer account is built in, so it just works) or TheGamesDB (your own free API key). Pick it from the GUI Source dropdown or the CLI
--sourceflag. - Credentials for both. A personal ScreenScraper account is optional (higher quota); TheGamesDB needs your key. Set them in Credentials... or with
--ss-user/--ss-pass/--tgdb-key. - Scrape what you highlight. Ctrl/Shift click to select several games (or search then select) and use Scrape Selected. Or scrape the whole library.
- Search and choose. New Search & Choose... dialog: search a source by keyword and pick exactly which result and which art (cover, background, or both) to apply. CLI
--titleoverrides the search term. - Region still defaults to World.
Everything from v1.2.0 is unchanged. Download the binary for your system below (Windows, macOS Intel/Apple Silicon, Linux); you still need adb on your PATH.
v1.2.0 - ScreenScraper scraping
GammaOS Boxart Tool v1.2.0
New: scrape covers and backgrounds from ScreenScraper.fr, from your PC.
- Scrape one game or your whole library, from both the GUI (Scrape This Game / Scrape Library...) and the CLI (
scrape,scrape-all). - GammaOS's ScreenScraper developer account is built into the official binaries, so scraping works out of the box. Add your own free ScreenScraper account for higher quota (GUI Account..., or
--ss-user/--ss-pass). - Region defaults to World for the widest art and international titles (
--region us|eu|jp|wor). - Only games missing art are scraped by default; use overwrite to re-scrape.
- Matches games the same way GammaOS Nano does on-device (CRC + filename per system), so results match what the handheld would fetch, without loading it down.
Everything from v1.1.0 (view, set/replace cover and background, remove, bulk import/export) is unchanged.
Download the binary for your system below (Windows, macOS Intel/Apple Silicon, Linux). You still need adb on your PATH.
GammaOS Boxart Tool v1.1.0
Manage GammaOS Nano game cover art AND background (fan art) from your computer over ADB: view, add, replace, remove, and bulk import/export, with a desktop GUI and a full CLI. Everything shows up in the XMB, DSi and Minima themes.
Downloads
No Python needed. You still need adb (Android platform-tools) on your PATH and a GammaOS device with USB debugging on.
- Windows (x64): gammaos-boxart-windows-x86_64.exe
- macOS (Apple Silicon): gammaos-boxart-macos-arm64
- macOS (Intel): gammaos-boxart-macos-x86_64
- Linux (x64): gammaos-boxart-linux-x86_64
Run with no arguments to open the GUI, or pass a command (e.g. list) for the CLI. In the GUI, each game has a Cover panel and a Background (fan art) panel, each with its own Set / Replace button. On the CLI, add --fan to set/get/remove to act on the background.
The binaries are unsigned: on Windows use "More info" then "Run anyway"; on macOS right-click Open (or xattr -dr com.apple.quarantine ); on macOS/Linux chmod +x first.