Skip to content

A3D Manager Local v0.2.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Sep 06:29
· 12 commits to main since this release
v0.2.0
47b9d32
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Screenshots and Memories on the SD card, nearly every retail cartridge recognized, and a round of reliability fixes so interrupted transfers, quitting and failed saves can't lose data. A3D Manager Local is now a desktop app only.

Downloads

  • Linux: A3D-Manager-Local-0.2.0-x86_64.AppImage
  • Windows: A3D-Manager-Local-0.2.0-x64.exe (not code-signed; SmartScreen warns on first run)

Your data carries over from 0.1.0.

Added

  • Many more games recognized: the cartridge database grew from 343 to 936 IDs, covering nearly every retail release and revision in every region (including Japanese games such as Neon Genesis Evangelion). These games no longer show as "Unknown Cartridge" or get the Library tab.
  • Alternate search names from n64-flashcart-menu-metadata, so common alternate spellings of game titles also match in search.
  • Clean up orphaned unknowns (Settings → Cartridge List): finds "Unknown Cartridge" folders on the SD card that the console no longer tracks in its library.db, and deletes the ones you select.
  • Screenshots tab for each cartridge: browse the screenshots and 4K exports the console saved on the SD card, view them full size (at the console's 4:3 shape), save copies, and delete them.
  • Memories tab for each cartridge: lists the console's Memories (save states) with when they were made and on which 3Dos version, and backs them up as the complete, unchanged files, one at a time or all at once as a zip. The app never changes or deletes Memories.
  • A Custom tag in the cartridge grid marks carts outside the built-in database (homebrew, flash carts, reproductions).
  • Choosing which labels to keep shows what differs. When both this computer and the SD card have labels, the sync dialog lists the cartridges whose labels differ or exist on only one side.

Changed

  • The firmware check shows smoother feedback while checking.
  • The Help page explains how settings saves, Controller Pak backups and backup bundles work.

Fixed

  • Interrupted transfers no longer damage files. Everything the app writes, locally and to the SD card (labels, settings, library.json, Controller Pak saves, ownership and custom names), is written to a temporary file first and only then swapped in. If the app closes or the card is pulled mid-transfer, the previous file is still there, whole.
  • Replaced files are kept. Syncing labels keeps the previous labels.db as labels.db.bak, on the card and locally. Replacing a local Controller Pak save keeps the old one as controller_pak.img.bak.
  • Downloading labels from the SD card checks the file first, so an invalid labels.db on the card can't replace your local labels.
  • Your owned list and custom names can't be wiped by a damaged file. If owned-carts.json or user-carts.json can't be read, it's kept as a .corrupt-<time> copy and the change shows an error, instead of the next change overwriting it with an empty list.
  • Simultaneous changes no longer overwrite each other (ownership, custom names, label edits, Controller Pak backups).
  • "Labels Synced" checks the SD card you selected, not whichever card was detected first, and a result for a previously selected card is ignored.
  • Copying a Controller Pak save to a card without that game's folder no longer fails for titles with characters the card can't store (such as :). New card folders are named the same way for settings, library.json and Controller Pak saves.
  • The app rejects any SD card path that isn't an Analogue 3D card, for every card operation.
  • Settings changes aren't lost when you quit. Closing the desktop app first sends any settings change still waiting to be saved, and lets file transfers in progress finish (each with a time limit).
  • Undoing a settings change within two seconds no longer saves the change. Before, switching a setting and switching it back left the first change queued, and it was saved anyway.
  • A failed settings save is kept and can be retried. The Settings tab shows when changes are unsaved or saving, and a Retry button when a save fails. Saves for one cartridge no longer run at the same time.
  • Failures are reported instead of looking like success. Importing or resetting settings, and restoring a Controller Pak backup, now say when the local save worked but the SD card copy failed. Changing ownership (one cart or several) and removing a custom name show the error and leave things as they were.
  • Backups (.a3d bundles) now include library details and custom names. Library details travel with Settings and custom names with Labels, in full and selection exports.
  • Label artwork from selection bundles can be imported. The import dialog only offered labels for bundles with a full labels database.
  • Unticking Game Pak backups when exporting now leaves them out.
  • Bundles are checked before anything is imported: cartridge IDs, the labels database, Controller Pak saves, library details and the unpacked size. Entries that fail are skipped and listed, instead of being written or failing the whole import.
  • Controller Pak saves are backed up automatically before they're replaced, locally or on the SD card (importing, restoring, downloading, uploading or a bundle import). The replaced save appears in the backup list as "Automatic: …", unless an identical backup already exists.
  • If deleting orphaned folders fails partway through, the folders already deleted still come off the owned list.
  • The filter dropdown arrows no longer sit against the right edge.

Removed

  • Browser and Docker versions. A3D Manager is a desktop app only now: the Dockerfile, docker-compose.yml, .env settings and the npm run dev / npm start browser setup are gone. Development uses npm run electron:dev.
  • Debug tools from upstream: the Debug Benchmark, Chunk Size Benchmark and Labels Database Comparison under Advanced Settings (the sync dialog shows label differences), and the component test page.

Known issues

  • On Ubuntu 24.04 and later, start the AppImage with --no-sandbox if it doesn't open.
  • The dev version (npm run electron:dev) and the AppImage keep separate data folders.
  • HDR screenshots haven't been tested yet. They're shown and copied from the original file, but thumbnails may look different from the console.
Assets 4
Loading