A3D Manager Local v0.3.0

Syncing labels now merges both ways, so labels on the SD card are never lost, plus fixes for SD card detection on Linux and saving on Windows.

Downloads

• Linux: A3D-Manager-Local-0.3.0-x86_64.AppImage
• Windows installer: A3D-Manager-Local-0.3.0-x64-installer.exe
• Windows portable: A3D-Manager-Local-0.3.0-x64-portable.exe, runs without installing

The Windows files aren't code-signed; SmartScreen warns on first run. Your data carries over from 0.2.x.

Added

• Sync merges labels both ways. When both this computer and the SD card have labels, Sync copies labels that are only on the SD card to this computer, then writes all your labels to the card. Where a cartridge's label differs, this computer's is kept. Replacing one side entirely is still available, and now warns when it would delete labels that only the other side has.
• Clean up cartridges that are no longer on the card (Settings → Cartridge List → Compare): also lists cartridges in the app's list that the SD card no longer has, for example after deleting them from the card in another copy of the app. Removing them only changes the app's list; nothing on the card changes.

Fixed

• Syncing labels could delete labels from the SD card. Before, choosing this computer's labels replaced the card's labels.db outright, so labels added from another computer or copy of the app were lost.

• Linux: SD card not detected when inserted after the app started (on Fedora, Arch, SteamOS and others the mount folder only appears with the first card after boot). Detection now checks /run/media and /media each time, including mounts outside a user folder (older SteamOS). A chosen folder no longer turns this off: if the card isn't there, the usual locations are still searched.

• Windows: saves could fail with "EPERM: operation not permitted, rename" when antivirus or Explorer briefly held a file the app had just written. Renames are retried for a few seconds, and deleting cartridge folders retries the same way.

A3D Manager Local v0.2.1

Fixes saving on Windows, and adds a portable Windows version.

Downloads

• Linux: A3D-Manager-Local-0.2.1-x86_64.AppImage
• Windows installer: A3D-Manager-Local-0.2.1-x64-installer.exe
• Windows portable: A3D-Manager-Local-0.2.1-x64-portable.exe, runs without installing

The Windows files aren't code-signed; SmartScreen warns on first run. The installed and portable versions share the same data.

Added

• Portable Windows version that runs without installing.

Changed

• The Windows installer is now named …-installer.exe.

Fixed

• Windows: changes failed with "operation not permitted, fsync". Marking cartridges as owned, custom names, settings, labels and Controller Pak saves all failed to save on Windows in 0.2.0. Windows can't force a folder to disk, which the new safe saving tried to do after each write.
• Windows: copying the firmware update to the SD card failed at its final step, for the same reason.

A3D Manager Local v0.2.0

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 3D^os 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.

A3D Manager Local v0.1.0

First release of A3D Manager Local, a fork of TheLeggett/A3D-Manager. See the README for the full feature list and install instructions.

NOTE: Windows version is untested as of right now, back up SD card and use at your own risk. I will be doing further testing but this should be considered an initial beta

Downloads

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

New compared to upstream

• Desktop app (Electron) with a native SD card picker, packaged as a Linux AppImage and a Windows installer. Upstream runs in a browser or Docker.
• 3D^os firmware updates: check for new releases, read the release notes, and copy the update to the SD card, verified against Analogue's checksum.
• 3D^os 1.5.1 support: reads and writes the new settings.json format, with the new options (Horizontal Upscaling, Overclock Off, Cartridge Color). Settings are only written to cards whose console is on 1.5.1 or later.
• Library tab for unknown cartridges (homebrew, flash carts, reproductions): edits their library.json title, details and default settings.
• Cartridge colors: the grid shows each cartridge in its console color, including default retail colors for carts that shipped in colored shells.
• Fixes: per-game settings now auto-save (upstream's Settings tab never saved), and game-name lookups work.
• Other: app icon, the Cartridges page remembers your All/Owned choice, Earthworm Jim 3D added to the cart database, Node.js 22.12+ required to run from source.

Coming next

• Missing game IDs: many retail games (especially Japanese releases) still show as "Unknown Cartridge"; the cart database will be expanded to cover nearly every release.
• Screenshot management for the console's Gallery and Memories folders.

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.