material-lab 1.0.0

The first release of material-lab, the free command-line companion to Material Lab for Mac and Material Capture for iPhone. Turn a photograph into an editable set of PBR texture maps, entirely on your Mac.

Install with Homebrew

brew tap theisegoria/material-lab-cli https://github.com/theisegoria/material-lab-cli
brew trust theisegoria/material-lab-cli    # Homebrew 7 asks you to trust third-party taps once
brew install material-lab

Or download material-lab-1.0.0-macos-arm64.tar.gz below (check it against the .sha256). Requires an Apple Silicon Mac with macOS 15 or later. The binary is Developer ID signed but not yet notarized: after a browser download, run xattr -dr com.apple.quarantine material-lab-1.0.0-macos-arm64 once.

What it does

• Derives albedo, 16-bit height, normal, roughness, ambient occlusion, cavity, convexity, slope and edge maps, with an optional bent normal and ORM, from one photo. About 0.1 s for a 1K material on Apple silicon.
• --learned runs the bundled MoGe-2 geometry model on the Neural Engine, so recesses like mortar and grout read the right way round.
• --repair-albedo auto rebuilds the photo so it tiles, cutting along the least visible seam.
• --export / --also-export to glb, usdz, unreal, unity-hdrp, godot and blender.
• Catalog batches with --jobs and --report, --watch folders, recipe files and recipes saved in the Material Lab Mac app.
• --info, --contact-sheet and --diff to inspect any bundle; --validate to check one.
• No account and no network: everything runs locally.

Every derived map is an estimate from one photograph, and each bundle records exactly how it was made. man material-lab documents every option.