Toolkit for converting emulation on Mac (ROM formats, disk images, metadata).
Last updated:
Architecture
Mac OS X - macOS
Download and links
- Download MacMan
- Source code 16 GitHub stars
Version history
0.5.0
- Ajout d’un mode NSZ pour compresser sans perte les dumps Nintendo Switch (NSP/XCI → NSZ/XCZ) et les restaurer (NSZ/XCZ → NSP/XCI), avec vérification de hachage.
- Interface de conversion avec progression en temps réel (pourcentage par fichier), prise en charge du drag-and-drop et des lots, logs en direct.
- Options de compression avancées : niveaux (1–22), modes Solid/Block/Automatique, vérification rapide/approfondie, gestion des threads et taille de bloc.
- Détection automatique des clés Nintendo (prod.keys) stockées dans ~/.switch/ ou ~/.config/nsz/, sans copie du fichier.
- Exclusivité Apple Silicon : le mode NSZ n’est pas disponible sur les Mac Intel, avec message d’erreur clair et désactivation du convertisseur.
Switch NSZ Mode
MacMan can now losslessly compress Nintendo Switch dumps, using nsz. An NSZ is an NSP whose NCA files have been compressed with zStandard; an XCZ is the same idea for an XCI. Both stay installable on a modded console.
- NSP/XCI → NSZ/XCZ — compresses a dump, losing nothing
- NSZ/XCZ → NSP/XCI — restores the original file, and turns a loose
.nczback into an.nca - Verify — re-hashes an existing dump and reports mismatches without writing anything
Batch input, drag-and-drop, live logs, and an output folder picker — same as every other converter in the app.
Real progress, not just a spinner
nsz is driven in machine-readable mode, so it reports structured progress instead of drawing terminal bars. This is the first tab with a live percentage inside a single file, rather than only per-file progress.
Compression options
- Level 1–22 (default 18) — higher is smaller and slower
- Solid for the best ratio, Block for random read access so a game can be played while still compressed, or Automatic to follow nsz's own defaults
- Quick or Full verification after compressing
- Thread count, long distance mode, block size, and overwrite
You need your own prod.keys
nsz cannot read a Switch dump without Nintendo's keys, and it needs them even to decompress. MacMan does not ship keys and never will — dump them from your own console.
If you already keep them at ~/.switch/prod.keys (or ~/.config/nsz/), MacMan finds them by itself and the Keys row shows which file it picked. Otherwise point it at your file once and it's remembered. Only the path is stored — the file itself is never copied.
Apple Silicon only
This mode does not work on Intel Macs. Upstream publishes an arm64 build and nothing else, and Rosetta translates Intel code to ARM rather than the other way round, so there is no workaround. MacMan says so on the tab, disables the converter, and doesn't offer you a 10 MB download that could never run.
Getting the tool
nsz is downloaded on demand from the Tool Status page (~10 MB, one click). No Homebrew, no Python, no terminal.
Requires macOS 14 or later. Every other converter is unchanged.
0.4.0
- Ajout d’un convertisseur bidirectionnel pour les packages PS4 (GP4 ↔ PKG) via PkgTool, avec prise en charge du batch, du glisser-déposer et des logs en temps réel.
- Correction automatique des chemins Windows (backslash et chemins absolus comme C:...) dans les projets GP4 pour éviter les plantages sur macOS.
- Téléchargement automatique de PkgTool (30 Mo) depuis un lien intégré, sans nécessiter Homebrew, .NET ou terminal.
- Rosetta 2 obligatoire sur Apple Silicon pour exécuter l’outil externe (PkgTool), avec une alerte si absent.
PS4 PKG Mode
MacMan can now convert PS4 packages in both directions, using PkgTool from LibOrbisPkg.
- GP4 → PKG — packs the files a GP4 project references into an installable fake PKG
- PKG → GP4 — unpacks a PKG into loose files plus an editable
Project.gp4
Batch input, drag-and-drop, live logs, and an optional passcode field for unpacking non-fake PKGs — same as every other converter in the app.
Windows GP4 projects work without editing
GP4 files written by Windows tooling use backslash paths, and often absolute C:\... paths from the machine that made them. PkgTool takes those literally and crashes on macOS. MacMan rewrites them automatically into a temporary copy — your project file is never modified.
Getting the tool
PkgTool is downloaded on demand from the Tool Status page (~30 MB, one click). No Homebrew, no .NET, no terminal.
Rosetta 2 is required on Apple Silicon — upstream only publishes an Intel build. MacMan tells you if it's missing:
0.3.0
- Compatibilité macOS renforcée : nécessite macOS 14 (Sonoma) et Apple Silicon (M1/M2/M3) uniquement, avec signature ad-hoc nécessitant une ouverture manuelle.
- Correction majeure du glisser-déposer : les fichiers .iso/.bin se chargent correctement dans les convertisseurs (le sélecteur de fichiers fonctionnait déjà).
- Dolphin et outils intégrés : détection automatique de dolphin-tool dans /Applications et intégration de ecm/unecm pour éviter une installation manuelle.
- Fonctionnalités Wii U et conversions : gestion corrigée des clés et noms de fichiers pour JWUDTool, suppression du mode "Verify" non supporté.
- Corrections techniques : chdman surécrit les fichiers existants, maxcso fonctionne pour la compression/décompression PSP/PS2, et NKit utilise les bons outils.
Stability release: fixes several converters and bundles more tools so they work out of the box.
Requires macOS 14 (Sonoma) or later · Apple Silicon.
Fixed
- Drag & drop now works. Dropping
.iso/.bin/etc. onto a converter window did nothing before — files now load correctly. (Adding files via the picker was unaffected.) - Dolphin is detected again. MacMan now finds
dolphin-toolinside an installed Dolphin.app (in/Applicationsor~/Applications) — no more "not found" when Dolphin is installed. - ECM works out of the box. Homebrew removed the
ecmformula upstream, soecm/unecmare now bundled with the app — no install step. - PSP/PS2 CSO conversion fixed.
maxcsocompress and decompress were failing on every file — both work now. (The non-functional level slider was removed; maxcso picks the best method automatically.) - CHD re-runs no longer fail.
chdmannow overwrites an existing output, so re-converting a file (or retrying after Cancel) no longer errors with "file already exists".
Bundled tools
- wit (Wiimms ISO Tools) is now bundled, so GameCube/Wii ISO ↔ WBFS ↔ CISO ↔ WDF conversion works without a separate install. (Runs via Rosetta 2 on Apple Silicon.)
Also improved
- Wii U (JWUDTool): key files are now handled correctly, output images are saved with the right name, and the unsupported single-image "Verify" mode was removed.
- NKit: now calls the correct NKit command-line tools (earlier builds looked for a file that doesn't exist in any NKit release).
Installing / first launch
This build is ad-hoc signed (not notarized), so macOS will warn on first launch:
- Drag MacMan.app into Applications.
- Right-click the app → Open → Open (first time only).
Or run: xattr -dr com.apple.quarantine /Applications/MacMan.app
0.2.0
- Correction des outils CHD pour un traitement correct des disques DVD (PS2, GameCube, Wii) via createdvd/extractdvd**, avec ajout d’un sélecteur CD/DVD pour les entrées ISO.
- Ajout d’un bouton Annuler sur tous les convertisseurs, stoppant aussi le processus en cours.
- Affichage des logs en temps réel, mieux ordonnés et optimisés, avec couleurs pour les lignes de succès/échec.
- Détection des outils externalisés (chdman, DolphinTool, etc.) exécutée hors du thread principal, évitant les blocages à l’ouverture ou lors du refocus.
- Suppression de code mort et correction des avertissements de concurrency dans le code interne.
A native macOS utility for converting and patching game disc images and ROMs — CHD, RVZ/GCZ/WIA, NKit, WBFS/ISO, CSO/ZSO, ECM, Wii U (WUD/WUX), ROM patching (XDelta/IPS/BPS), and ROM verification — wrapping well-known open-source CLI tools behind a clean SwiftUI interface.
Universal build — runs on both Apple Silicon and Intel Macs. Requires macOS 14 or later.
Installation
- Download
MacMan-0.2.0.dmgbelow and open it. - Drag MacMan into your Applications folder.
- The app is not notarized, so on first launch macOS Gatekeeper will block it. To open it:
- Right-click MacMan.app → Open → Open, or
- run
xattr -dr com.apple.quarantine /Applications/MacMan.appin Terminal once.
Helper tools (chdman, DolphinTool, maxcso, xdelta3, flips, wit, NKit, JWUDTool) are installed on demand from the Tool Status tab.
What's in 0.2.0
Fixes
- CHD: correctly use
createdvd/extractdvdfor DVD-based discs (PS2 · GameCube · Wii); added a CD/DVD selector for ISO input. Previously these produced invalid or mislabeled output. - Tool output no longer drops its final line (process pipes are fully drained on exit).
Improvements
- Cancel button on every converter — cancelling now also stops the running tool process.
- Tool detection runs off the main thread, so the app no longer hangs briefly on launch or when refocused.
- Live logs stream in order and far more efficiently; ✓/✗ lines are colored.
- Build-from-source tools are located more reliably; duplicate file drops are ignored; ROM verifier surfaces per-file errors.
Internal
- Removed dead code, fixed concurrency warnings, and synced the architecture docs.
0.1.0
- Interface SwiftUI intégrant dix modes de conversion (CHD, RVZ/GCZ/WIA, NKit, WBFS/ISO/CISO/WDF, Wii U, CSO/ZSO, ECM, Patch ROM, Verify ROM, Tool Status) via outils open-source.
- Prise en charge native de macOS 14 (Sonoma) et au-delà, avec build universel pour Apple Silicon (M1/M2/M3) et Intel.
- Installation via .dmg avec avertissement Gatekeeper initial nécessitant une action manuelle (clic droit + "Ouvrir" ou suppression du flag quarantine).
- Installation automatique des outils externes (chdman, Dolphin, etc.) depuis l’onglet Tool Status lors de l’usage.
- Prise en charge du glisser-déposer pour lots de fichiers, avec logs et suivi des progrès en temps réel.
The first public release of MacMan — a native macOS utility for converting and patching game disc images and ROMs. Drag in your files, click convert, done.
Features
Ten conversion modes wrapping well-known open-source tools behind a clean SwiftUI interface:
- CHD — compress and extract PS1 / PS2 / Dreamcast / Saturn / Sega CD images (
chdman) - RVZ / GCZ / WIA — GameCube and Wii via Dolphin's tools
- NKit — lossless GameCube/Wii preservation format (Mono + NKit.exe)
- WBFS / ISO / CISO / WDF — Wii image conversion with FAT32-friendly splitting (
wit) - Wii U — WUD/WUX compress, decompress, extract, decrypt (JWUDTool)
- CSO / ZSO — PSP image compression (
maxcso) - ECM — PS1 BIN compression (
ecm/unecm) - Patch ROM — apply XDelta, IPS, and BPS patches (
xdelta3+flips) - Verify ROM — CRC32 / MD5 / SHA-1 hashing with No-Intro / Redump DAT matching
- Tool Status — install, build, download, or uninstall every helper tool with one click
Batch input via drag-and-drop, live conversion logs, and progress tracking for every mode.
Requirements
- macOS 14 (Sonoma) or later
- Universal binary — runs natively on both Apple Silicon and Intel Macs
- Helper tools (chdman, dolphin-tool, etc.) are installed on demand from the Tool Status view
Installation
- Download
MacMan.dmgbelow - Open the DMG and drag MacMan to your Applications folder
First launch
This build is ad-hoc signed (not notarized by Apple), so on first launch macOS Gatekeeper will refuse to open it. Either:
- Right-click MacMan.app → Open, then click Open on the warning dialog, or
- Run
xattr -dr com.apple.quarantine /Applications/MacMan.appin Terminal to clear the quarantine flag
You only need to do this once — subsequent launches work normally.
Known limitations
- The auto-build paths for
flipsandwituse plainmakeand may need a manual install on some setups. Fallback instructions are in the README. - IPS/BPS patching requires
flips; install it via Tool Status before applying those patch types. - NKit mode requires Mono (
brew install mono) and a manualNKit.exeplaced in~/Library/Application Support/MacMan/bin/.
Source
Full source, build instructions, and per-mode user guide: README.md
Reply on the forum
A question or a hands-on report? Open the discussion on the forum.