The unofficial companion app for managing your Analogue 3D N64 cartridge collection.
A3D Manager is a desktop utility that lets you manage label artwork, per-game display and hardware settings, and controller pak saves for your Analogue 3D. Build and maintain your perfect cartridge library with full control over every aspect of your N64 gaming experience.
Browse and manage your entire N64 cartridge collection:
- Real-time search by game name or cart ID
- Filter by region, language, and video mode (NTSC/PAL)
- Toggle between All and Owned to focus on your personal collection
- Smart badges identify known games, custom names, and unknown/homebrew carts
- Selection mode for bulk operations on multiple cartridges
Configure display settings individually for each cartridge:
- Display Mode: BVM, PVM, CRT, Scanlines, or Clean
- CRT Mode Options: Beam Convergence (Horizontal/Vertical), Edge Overshoot, Edge Hardness, Image Size, Image Fit
- Clean Mode Options: Interpolation Algorithm, Gamma Transfer, Sharpness, Image Size, Image Fit
- Copy & Paste Settings: Copy settings from one cartridge and paste to multiple others in bulk using Selection Mode
Fine-tune hardware behavior for each game:
- Virtual Expansion Pak toggle
- Region Override: Auto, NTSC, or PAL
- De-Blur enhancement
- 32-bit Color mode
- Disable Texture Filtering option
- Disable Antialiasing option
- Force Original Hardware mode
- Overclock: Auto, Enhanced, Enhanced+, or Unleashed
All settings changes sync automatically to your SD card when connected.
Full control over controller pak (Game Pak) save data:
- View save data usage with pages used, pages free, and capacity percentage
- Sync detection shows when local and SD card saves differ
- Download from SD to backup saves locally
- Upload to SD to restore saves
- Import/Export game pak files (.img format)
- Backup system with named backups, descriptions, restore, and export
Customize the label artwork displayed on the Analogue 3D home screen:
- Drag-and-drop image upload (PNG, JPG, WebP)
- Automatic resizing to the required 74x86 pixel format
- Side-by-side preview of current and new labels
- Custom names for homebrew and flash carts
Seamless synchronization with your Analogue 3D:
- Auto-detect connected Analogue 3D SD cards
- Real-time sync status indicator in the header
- Automatic settings sync when SD card is connected
- Conflict detection with resolution options when local and SD card data differ
- Import games from SD to discover cartridges you've played
Flexible backup and sharing options:
- Bundle Export (.a3d format) with selective data:
- Labels (artwork)
- Per-game settings
- Game Pak saves
- Game Pak backups
- Ownership data
- Selection Export to export specific cartridges
- Bundle Import with merge options for handling conflicts
- Import labels.db directly from file or community collections
Easy onboarding for new users:
- Import Games from SD Card: Scan your SD card to discover cartridges and download their settings
- Download Labels from SD Card: Import existing label artwork from your Analogue 3D
Real-time feedback during sync operations:
- Progress bar with percentage complete
- Transfer speed and data transferred
- Estimated time remaining
Comprehensive N64 cartridge database:
- 340+ Analogue 3D cart IDs mapped and annotated
- Automatic game name, region, language, and video mode lookup
- Support for homebrew and flash carts with custom naming
- Node.js 20 or higher
- An Analogue 3D with an SD card
Native installation is recommended for the best experience, especially if you frequently plug/unplug your SD card.
# Clone the repository
git clone git@github.com:TheLeggett/A3D-Manager.git
cd A3D-Manager
# Install dependencies
npm install
# Start the application
npm run devThe app will open at http://localhost:5173 with the backend API running on port 3001. Your SD card will be detected automatically and you can eject/re-insert it freely while the app runs.
A3D Manager can also run in Docker, though with some limitations around SD card handling:
# Using Docker Compose (recommended)
docker compose up -d
# Or build and run manually
docker build -t a3d-manager .
docker run -d \
--name a3d-manager \
-p 3001:3001 \
-v a3d-data:/app/.local \
a3d-managerThe app will be available at http://localhost:3001.
The Docker container mounts your Analogue 3D SD card directly. By default, it expects the standard mount path /Volumes/ANALOGUE 3D.
Important: Your SD card must be connected and mounted before running
docker compose up -d. If the SD card isn't mounted, Docker will fail with a "permission denied" error.
Connecting your SD Card:
You can either use an external SD card reader, or connect directly to your Analogue 3D via USB-C:
- Fully power off your Analogue 3D and disconnect all controllers and cables
- Leave the SD card inserted in the Analogue 3D
- Connect the Analogue 3D's power port to your computer using USB-C and wait 5 seconds
- Press and hold the reset button, then while holding reset, press and hold the power switch
- Hold both buttons until the Power LED turns green, then release
- Your SD card should now appear as
ANALOGUE 3Don your computer
See Analogue's guide for more details.
Initial Setup (macOS):
- Connect your SD card (see above)
- Run
docker compose up -d
Initial Setup (Linux):
- Create a
.envfile with your SD card path:cp .env.example .env # Edit SD_VOLUMES_PATH, e.g.: SD_VOLUMES_PATH=/media/$USER/ANALOGUE 3D
- Run
docker compose up -d
If your SD card has a different name, create a .env file:
SD_VOLUMES_PATH=/Volumes/YOUR_SD_CARD_NAMEDue to how Docker Desktop works on macOS, you must quit Docker Desktop entirely before ejecting your SD card. The Docker VM keeps file shares active even when containers are stopped.
Workflow for ejecting:
- Stop the container:
docker compose down - Quit Docker Desktop (click Docker icon in menu bar → Quit Docker Desktop)
- Eject your SD card normally
When ready to use again:
- Connect your SD card first (it must be mounted before starting Docker)
- Start Docker Desktop
- Run
docker compose up -d
Note: If you frequently need to eject your SD card, consider using the native installation instead, which has no restrictions on SD card ejection.
| Variable | Default | Description |
|---|---|---|
PORT |
3001 |
Server port |
SD_VOLUMES_PATH |
/Volumes/ANALOGUE 3D |
Path to your Analogue 3D SD card |
TRANSFER_CHUNK_SIZE |
2097152 |
File transfer chunk size (bytes) |
TRANSFER_FSYNC_PER_CHUNK |
true |
Sync after each chunk for accurate progress |
READ_LABELS_FROM_SD |
false |
Read labels directly from SD card (slower) |
- Connect your SD card - Insert your Analogue 3D SD card into your computer
- Import your games - Use "Import Games from SD Card" to discover your cartridges
- Browse and configure - Search for games, adjust settings, upload artwork
- Changes sync automatically - When your SD card is connected, changes sync in real-time
The Analogue 3D identifies N64 cartridges using a CRC32 checksum of the first 8 KiB of ROM data. This creates a unique 8-character hex ID for each cartridge. A3D Manager uses these IDs to associate custom label artwork, display settings, hardware settings, and controller pak saves with each cartridge.
- Local storage: All data is stored in
.local/until explicitly synced - SD card sync: When connected, settings and game paks sync automatically
- Labels: Synced via the "Sync Labels" button in the header
- Labels DB Specification - Binary format details
- Cart ID Algorithm - How cartridge identification works
- SD Card Format - Analogue 3D SD card structure
- Cartridge Management - Per-game settings and game pak management
- Frontend: React 19 + TypeScript + Vite
- Backend: Express.js + TypeScript
- Image Processing: Sharp
A3D Manager is an unofficial, community-created tool and is not affiliated with, endorsed by, or connected to Analogue, Inc. Use at your own risk. Always back up your SD card before making changes.
Contributions are welcome! Feel free to open issues or submit pull requests.
MIT License - see LICENSE for details.