v0.4.1

GBBox 0.4.1 Release Notes

Highlights

• Fixed VIC-20 imports failing with Unsupported platform: vic20 during backend database conversion.
• Made VIC-20 platform naming more forgiving: vic20, VIC-20, VIC 20, and Commodore VIC-20 all resolve to the same platform.
• Updated VIC-20 import metadata to match the real Vic20_v03.mdb source filename.
• Removed the dated graphify-out/2026-06-28 backup snapshot from Git and ignored future dated Graphify backup folders.

Validation

The release source was prepared to pass:

npm run lint
npm run test:frontend
npm run test:backend
npm run build

Release bundles are produced by the GitHub Actions Release Bundles workflow when the v0.4.1 tag is pushed.

v0.4.0

GBBox 0.4.0 Release Notes

Highlights

• Added Atari ST as an importable platform with Extras, Games, Screenshots, and Music folder setup.
• Added Commodore VIC-20 as an importable platform with the same folder setup flow as the other retro platforms.
• Added RetroArch support for both platforms, plus STeem and Hatari external emulator options for Atari ST and VICE for VIC-20.
• Added Atari ST and VIC-20 windowed library backgrounds from docs/images/backgrounds.

Validation

The release source was prepared to pass:

npm run lint
npm run test:frontend
npm run test:backend
npm run build

Release bundles are produced by the GitHub Actions Release Bundles workflow when the v0.4.0 tag is pushed.

v0.3.1

GBBox 0.3.1 Release Notes

Highlights

• Increased the windowed grid and list platform background image visibility by about 20%.
• Kept the existing platform-specific rotating background behavior and overlay treatment.

Validation

The release source was prepared to pass:

npm run lint
npm run test:frontend
npm run test:backend
npm run build

Release bundles are produced by the GitHub Actions Release Bundles workflow when the v0.3.1 tag is pushed.

v0.3.0

GBBox 0.3.0 Release Notes

Highlights

• Added Acorn BBC Micro and Commodore Amiga as supported GameBase import platforms.
• Added platform setup for BBC Micro and Amiga using the shared GameBase folder shape: Extras, Games, Screenshots, and Music.
• RetroArch is the default launch profile for both new platforms.
• Added BeebEm as the BBC Micro external emulator option.
• Added WinUAE / UAE-style Amiga external launch support, with WinUAE on Windows and equivalents such as FS-UAE or Amiberry on Linux/macOS.
• Added subtle rotating platform backgrounds for the windowed grid and list views using the images in docs/images/backgrounds.
• Fixed Amiga multi-disk launch packaging so _Disk1.zip, _Disk2.zip, and other sibling disk archives are temporarily extracted together before launch.

Amiga Multi-Disk Launching

• RetroArch now receives an .m3u built from the extracted disk image files, not just the selected zip archive.
• WinUAE / UAE launches now attach the first extracted disks with -0, -1, -2, and -3 drive switches where available.
• WinUAE / UAE launches also preload all extracted disks through -diskswapper=... so additional disks are available through the emulator disk swapper.
• This covers GameBase Amiga records where the database points at a *_Disk1.zip file while emulator metadata, such as nr_floppies=2, indicates a multi-disk game.

Supported Imports

• Commodore 64 / GameBase64: VICE, RetroArch, in-app EmulatorJS/VICE, SID playback, extras, screenshots, and GameBase64 metadata.
• Atari 800: Atari 800 v12-compatible GameBase MDB imports with Games, Music, Photos, Screenshots, and Extras paths. Launch settings support RetroArch Atari800 and Altirra.
• Atari 2600: Atari 2600 GameBase MDB imports with Games, Screenshots, and Extras paths. Launch settings use RetroArch and an Atari 2600 core.
• ZX Spectrum / GameBaseZX / SpeccyMania: Sinclair ZX Spectrum v6-compatible GameBase MDB imports with Extras, Games, Screenshots, Musician Photos, and Music paths. Launch settings support RetroArch and Spectaculator.
• Acorn BBC Micro: GameBase MDB imports with Extras, Games, Screenshots, and Music paths. Launch settings support RetroArch and BeebEm.
• Commodore Amiga: GameBase MDB imports with Extras, Games, Screenshots, and Music paths. Launch settings support RetroArch and WinUAE / UAE-style external emulators.

Known Limitations

• Database files, ROMs, screenshots, music, extras, and other GameBase media are not included.
• ZX Spectrum .ay files and Amiga music files are recognized as media, but in-app JavaScript/WebAudio playback still needs a dedicated player evaluation.
• Windows local MDB export still requires the Microsoft Access Database Engine / ACE provider.
• Amiga sibling-disk detection expects conventional _DiskN.zip naming beside the selected archive.

Validation

The release source was prepared to pass:

npm run lint
npm run test:frontend
npm run test:backend
npm run build

Release bundles are produced by the GitHub Actions Release Bundles workflow when the v0.3.0 tag is pushed.

v0.2.0

GBBox 0.2.0

GBBox 0.1.0

GBBox 0.1.0 Release Notes

Highlights

• 64Box is now GBBox, short for GameBase Box.
• GBBox is positioned as a local-first desktop frontend for GameBase-style retro game libraries.
• The first public GBBox release supports imports for Commodore 64, Atari 800, and Atari 2600.
• Platform-scoped paths, import status, emulator settings, favorites, and navigation state keep each imported library separate.

Supported Imports

• Commodore 64 / GameBase64: Baseline support with VICE, RetroArch, in-app EmulatorJS/VICE, SID playback, extras, screenshots, and GameBase64 metadata.
• Atari 800: Atari 800 v12-compatible GameBase MDB imports with Games, Music, Photos, Screenshots, and Extras paths. Launch settings support RetroArch Atari800 and Altirra.
• Atari 2600: Atari 2600 GameBase MDB imports with Games, Screenshots, and Extras paths. Launch settings use RetroArch and an Atari 2600 core.

More GameBase platforms are planned.

Installation and Artifacts

Download attached build artifacts from the GitHub release page. Artifact names should use GBBox/GameBaseBox branding where the platform packaging format allows it.

If only one platform artifact is attached, that means the first public release was built on that host platform. Additional platform artifacts can be added once their build environments are available.

Validation

The release source should be validated with:

npm run lint
npm run test:frontend
npm run test:backend
npm run build

The release build should also run the project Tauri build command and attach the resulting files from src-tauri/target/release/bundle/.

Known Limitations

• Database files, ROMs, screenshots, music, extras, and other GameBase media are not included.
• Atari platform coverage starts with Atari 800 and Atari 2600 import support; more GameBase profiles are expected later.
• Existing local C64/GameBase64 paths remain platform-specific and are intentionally not renamed.

Migration from 64Box

GBBox is the continuation of 64Box under a platform-neutral name. Existing local libraries and settings should remain local and user-controlled. The old repository now points users to the new public GameBaseBox repository.