Repository navigation
mac2jb v0.3.1
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-driverfrom 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.