Skip to content

mac2jb v0.3.1

Choose a tag to compare

@cpypwn cpypwn released this 24 Oct 05:20

mac2jb v0.3.1 bundles the tested unsigned USB gadget driver and streamlines its setup in both the GUI and CLI.

  • GUI: use Install & load driver… to verify, install, and request loading of the bundled driver through a macOS administrator prompt.
  • CLI: choose option 4, or run bash mac2jb.command --install-driver from the complete source checkout.
  • Existing drivers are preserved in uniquely named backups. Installation activity and errors are logged, and sessions are blocked until the required restart has occurred and the driver is reported loaded.
  • The complete source archive now includes drivers/usbgadget.kext, SHA-256 checksums, provenance, licenses, and the source-build fallback.
  • SIP/Recovery instructions are clearer. SIP must be disabled for this unsigned-driver setup; mac2jb never changes SIP or startup security automatically. Complete any macOS approval/restart prompts before starting a session.

The bundled driver is the maintainer's local version 1.01 arm64e build with its personal development signature removed. The unsigned copy passed reboot/loading, USB enumeration, and typing tests, followed by maintainer testing of the GUI and CLI workflows. Other hardware and OS combinations remain unverified. The app remains ad-hoc signed and not notarized.

Thanks to SocraticBliss for feedback and guidance on simpler driver installation and clearer SIP requirements. The driver and USB gadget work are by Max Thomas / shinyquagsire23; upstream credits and licenses are retained. ns2jb attribution and notices remain included.

Download mac2jb-v0.3.1-macos-arm64.zip for the app, or mac2jb-v0.3.1-source.zip for the complete source with GUI and CLI support. Both include the unsigned driver. Follow the README's recommended bundled-driver setup; build instructions remain available as a fallback.