MacMan

Utility 0.5.0

Toolkit for converting emulation for Mac.

Toolkit for converting emulation on Mac (ROM formats, disk images, metadata).

MacMan

Last updated:

Architecture

Mac OS X - macOS Mac OS X - macOS

Download and links

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 .ncz back 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-tool inside an installed Dolphin.app (in /Applications or ~/Applications) — no more "not found" when Dolphin is installed.
  • ECM works out of the box. Homebrew removed the ecm formula upstream, so ecm/unecm are now bundled with the app — no install step.
  • PSP/PS2 CSO conversion fixed. maxcso compress 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. chdman now 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:

  1. Drag MacMan.app into Applications.
  2. Right-click the app → Open → Open (first time only).

Or run: xattr -dr com.apple.quarantine /Applications/MacMan.app

Reply on the forum

A question or a hands-on report? Open the discussion on the forum.

Reply on the forum